java.util.jar
인터페이스 Pack200.Packer

포함되어 있는 클래스:

Pack200

public static interface Pack200.Packer

packer 엔진은 다양한 변환을 입력 JAR 파일에 적용해, 팩스트림을 gzip 나 zip 등의 압력을 사용해 큰폭으로 압축 가능하게 합니다. 엔진의 인스턴스는 Pack200.newPacker()를 사용해 취득할 수 있습니다. 고도의 압축은 JSR 200 사양으로 설명되고 있는 다수의 테크닉을 사용해 실현됩니다. 이러한 기술에는 정수 풀의 소트, 재순서 붙여 및 동위값의 배값이 포함됩니다.

pack 엔진은 초기화되면, 다음에 나타내는 프로퍼티로 규정된 초기 상태가 됩니다. 초기 상태를 조작하려면, (properties()를 사용해) 엔진 프로퍼티를 취득하고 나서, 수정한 프로퍼티를 맵에 포함합니다. resource file는 일절 변경없이 건네받습니다. unpacker는 정수 풀 유순한 어느 일반적이지 않는 클래스 파일 기능에 자유롭게 변경할 수 있기 때문에 클래스 파일에는 동일한 바이트는 포함되지 않습니다. 다만, 「Java 가상 머신 사양」(http://java.sun.com/docs/books/vmspec/html/ClassFile.doc.html )로 지정되고 있도록, 이러한 클래스 파일은 미적으로 동일합니다.

디폴트에서는 packer가 JAR 요소의 순서를 변경할 것은 없습니다. 또, 각 JAR 요소의 수정 시간 및 디플레이션 힌트는 변경을 더해지지 않고에게 건네집니다 (Unix 파일의 접근 권한을 부여하는 추가 속성등의, 다른 ZIP 어카이브(archive) 정보는 없어진다).

일반적으로 JAR 팩 및 unpack에의해 JAR 클래스 파일내에 있는 바이트 단위의 컨텐츠가 변경됩니다. 이것은 보통, 팩 및 unpack에의해 JAR 요소의 바이트 단위 이미지에 의존된 디지털 서명이 모두 무효가 되는 것을의미합니다. JAR 서명과 팩의 양쪽 모두를 실행하기 위해서는 최초로 JAR 팩과 unpack를 실행해 「정규화」하고 나서, unpack 된 JAR 요소상의 서명을 계산해, 마지막에 서명필의 JAR를 재팩 할 필요가 있습니다. 양쪽 모두의 팩 순서로 정확하게 같은 옵션을 사용해 주세요. 또, 클래스 파일의 사이즈는 미묘하게 변화하기 위해, 세그먼트(segment) 경계를 도하지 않고 로 변경해 버리는 것을 피하기 위해서 세그먼트(segment) 제한을 「-1」으로 설정하는 것이 필요한 경우도 있습니다.

(이것이 기능하는 이유는 다음과 같이. 클래스 파일 구조에 대해서 packer가 실행하는 재순서부는 나무등이기 때문에 2번째의 팩으로 최초의 패킹에 의해 생성된 순서가 변경될 것은 없다. 또, JSR 200 사양에의해 unpacker는 어카이브(archive) 요소의 특정의 전송 순서에 대해서 지정된 바이트 단위 이미지를 생성하는 것이 보증되고 있다. )

필드 개요

static String	CLASS_ATTRIBUTE_PFX 클래스 속성명에 연결되었을 경우, JSR 200 사양으로 지정된 레이아웃 언어를 사용해, 그 속성의 형식을 나타냅니다.
static String	CODE_ATTRIBUTE_PFX 코드 속성명으로 연결해 사용되었을 경우, 속성의 형식을 나타냅니다.
static String	DEFLATE_HINT 이 프로퍼티가 TRUE 또는 FALSE 로 설정되면, packer는 출력 어카이브(archive)내에서 거기에 응한 디플레이션 힌트를 설정합니다.
static String	EFFORT 이 프로퍼티가 1 자리수의 10 진수로 설정되면, packer는 지정된 양의 노력을 어카이브(archive)의 압축에 소비합니다.
static String	ERROR 캐릭터 라인 「error」는 특정의 프로퍼티로 사용할 수 있습니다.
static String	FALSE 캐릭터 라인 「false」는 특정의 프로퍼티로 사용할 수 있습니다.
static String	FIELD_ATTRIBUTE_PFX 필드 속성명으로 연결해 사용되었을 경우, 속성의 형식을 나타냅니다.
static String	KEEP 캐릭터 라인 「keep」는 특정의 프로퍼티로 사용할 수 있습니다.
static String	KEEP_FILE_ORDER 이 프로퍼티가 TRUE 로 설정되면, packer는 소스 어카이브(archive)내의 모든 요소를 원의 순서로 전송 합니다.
static String	LATEST 캐릭터 라인 「latest」는 특정의 프로퍼티로 사용할 수 있습니다.
static String	METHOD_ATTRIBUTE_PFX 메서드 속성명으로 연결해 사용되었을 경우, 속성의 형식을 나타냅니다.
static String	MODIFICATION_TIME 이 프로퍼티가 특수한 캐릭터 라인 LATEST 로 설정되면, packer는 원의 어카이브(archive)내의 이용 가능한 전엔트리내에서 최신의 수정 시간, 또는 각 세그먼트(segment)내의 이용 가능한 전엔트리의 최신의 수정 시간의 결정을 시도합니다.
static String	PASS 캐릭터 라인 「pass」는 특정의 프로퍼티로 사용할 수 있습니다.
static String	PASS_FILE_PFX 파일을 압축하지 않고 바이트 단위로 건네주는 것을 나타냅니다.
static String	PROGRESS unpacker 진척 상황을 퍼센트로 가리킵니다.
static String	SEGMENT_LIMIT 이 프로퍼티는 각 어카이브(archive) 요소의 추정 타겟 사이즈 N (단위는 바이트)를 부여하는 수치입니다.
static String	STRIP 캐릭터 라인 「strip」는 특정의 프로퍼티로 사용할 수 있습니다.
static String	TRUE 캐릭터 라인 「true」는 특정의 프로퍼티로 사용할 수 있습니다.
static String	UNKNOWN_ATTRIBUTE 불명한 속성을 포함한 클래스 파일에 조우했을 때에 실행하는 액션을 나타냅니다.

메서드 개요

void	addPropertyChangeListener (PropertyChangeListener listener) PropertyChange 이벤트의 리스너를 프로퍼티 맵에 등록합니다.
void	pack (JarFile in, OutputStream out) JarFile를 취득해, Pack200 어카이브(archive)로 변환합니다.
void	pack (JarInputStream in, OutputStream out) JarInputStream를 취득해, Pack200 어카이브(archive)로 변환합니다.
SortedMap <String, String >	properties () 이 엔진의 프로퍼티 세트를 취득합니다.
void	removePropertyChangeListener (PropertyChangeListener listener) addPropertyChangeListener(java.beans.PropertyChangeListener) 에 의해 추가된, PropertyChange 이벤트의 리스너를 삭제합니다.

필드의 상세

SEGMENT_LIMIT

static final String  SEGMENT_LIMIT

이 프로퍼티는 각 어카이브(archive) 요소의 추정 타겟 사이즈 N (단위는 바이트)를 부여하는 수치입니다. 단일의 입력 파일로 N 바이트를 넘는 바이트수가 필요한 경우, 이것에 독자적인 어카이브(archive) 세그먼트(segment)가 부여됩니다.

특수한 케이스로서 값 0 이 클래스 마다 1개의 세그먼트(segment)를 생성하는데 대해, 값 -1 이 모든 입력 파일을 포함한 단일의 대규모 세그먼트(segment)를 생성합니다. 어카이브(archive) 세그먼트(segment)가 커지면 fragmentation가 감소해, 압축율이 향상합니다만, 보다 많은 메모리가 처리에 필요하게 됩니다.

각 세그먼트(segment)의 사이즈는 세그먼트(segment)내에서 전송 되는 각 입력 파일의 사이즈 및 그 이름과 전송 되는 다른 프로퍼티의 사이즈를 계산하는 것으로 추측할 수 있습니다.

디폴트는 1000000 (바이트)입니다. 이것에 의해 중간 정도의 사이즈의 입력 JAR 파일을 있는 세그먼트(segment)내에서 전송 하는 것이 가능하게 됩니다. 이 값에의해 packer 및 unpacker 메모리 요건도 제한됩니다.

보통, 이 제한없이 팩 된 10M 바이트의 JAR는 약 10 % 불필요하게 작아집니다만, packer에는 보다 많은 Java heap (세그먼트(segment) 제한의 약 10 배)가 필요하게 됩니다.

관련 항목:

정수 필드값

KEEP_FILE_ORDER

static final String  KEEP_FILE_ORDER

이 프로퍼티가 TRUE 로 설정되면, packer는 소스 어카이브(archive)내의 모든 요소를 원의 순서로 전송 합니다.

이것이 FALSE 로 설정되면, packer는 요소를 재차 정렬 해, Java 어플리케이션에 관한 유용한 정보를 포함하지 않는 JAR 디렉토리 엔트리를 삭제합니다 (일반적으로 이것에 의해 압축율이 향상한다).

디폴트는 TRUE 입니다. 이것에 의해 입력 정보는 보존됩니다만, 전송 하는 어카이브(archive)의 사이즈가 필요이상으로 커지는 경우가 있습니다.

관련 항목:

정수 필드값

EFFORT

static final String  EFFORT

이 프로퍼티가 1 자리수의 10 진수로 설정되면, packer는 지정된 양의 노력을 어카이브(archive)의 압축에 소비합니다. 레벨 1 은 사이즈가 약간 커집니다만, 압축 속도가 고속으로 됩니다. 한편, 레벨 9는 압축에 시간이 걸립니다만, 압축율이 높아집니다.

특수한 값 0을 지정하면, packer는 원의 JAR 파일을 압축하지 않고 직접 카피합니다. JSR 200 표준에서는 unpacker가 이 특수한 케이스를 어카이브(archive) 전체의 파스스르로서 인식하는 것이 요구됩니다.

디폴트는 5 입니다. 이 설정에서는 중간 정도의 시간을 소비해 적당한 압축을 합니다.

관련 항목:

정수 필드값

DEFLATE_HINT

static final String  DEFLATE_HINT

이 프로퍼티가 TRUE 또는 FALSE 로 설정되면, packer는 출력 어카이브(archive)내에서 거기에 응한 디플레이션 힌트를 설정합니다. 어카이브(archive) 요소의 개별의 디플레이션 힌트가 전송 될 것은 없습니다.

이 프로퍼티가 특수한 캐릭터 라인 KEEP 로 설정되면, packer는 입력 어카이브(archive)내의 이용 가능한 요소 마다 독립한 디플레이션 힌트를 결정해, 힌트를 별개에 전송 하려고 시도합니다.

디폴트는 KEEP 입니다. 이것에 의해 입력 정보는 보존됩니다만, 전송 하는 어카이브(archive)의 사이즈가 필요이상으로 커지는 경우가 있습니다.

unpack 하는 jar 요소를 올바르게 압축하기 위해서 힌트를 적절히 처리하는 것은 unpacker 구현에 의존합니다.

ZIP 또는 JAR 요소의 디플레이션 힌트는 요소가 압축되었는지, 그대로 포함되었는지를 나타냅니다.

관련 항목:

정수 필드값

MODIFICATION_TIME

static final String  MODIFICATION_TIME

이 프로퍼티가 특수한 캐릭터 라인 LATEST 로 설정되면, packer는 원의 어카이브(archive)내의 이용 가능한 전엔트리내에서 최신의 수정 시간, 또는 각 세그먼트(segment)내의 이용 가능한 전엔트리의 최신의 수정 시간의 결정을 시도합니다. 이 단일의 값은 세그먼트(segment)의 일부로서 송신되어 각 세그먼트(segment) SEGMENT_LIMIT 내의 모든 엔트리에 적용됩니다.

이것에 의해 인스톨 된 파일 모든 것이 단일의 날짜와 시간로 설정되는 대신에 전송 하는 어카이브(archive)의 사이즈를 조금 감소시킬 수가 있습니다.

이 프로퍼티를 특수한 캐릭터 라인 KEEP 로 설정하면, packer는 입력 요소 마다 별개의 수정 시간을 전송 합니다.

디폴트는 KEEP 입니다. 이것에 의해 입력 정보는 보존됩니다만, 전송 하는 어카이브(archive)의 사이즈가 필요이상으로 커지는 경우가 있습니다.

출력 파일의 각 요소의 수정 시간을 올바르게 설정하기 위해서 적절한 처리를 실행하는 것은 unpacker 구현에 의존합니다.

관련 항목:

SEGMENT_LIMIT, 정수 필드값

PASS_FILE_PFX

static final String  PASS_FILE_PFX

파일을 압축하지 않고 바이트 단위로 건네주는 것을 나타냅니다. 복수의 파일을 지정하는 경우는 식별 가능한 캐릭터 라인이 부가된 추가 프로퍼티를 설정하는 것으로 한 무리의 프로퍼티에 공통의 접두사를 지정합니다.

시스템 파일 separator가 JAR 파일 separator 「/」으로 옮겨지는 점을 제외해, 패스명의 변환은 행해지지 않습니다.

생성되는 파일명은 JAR 파일에 기재된 캐릭터 라인과 정확하게 일치할 필요가 있습니다.

프로퍼티값이 디렉토리명의 경우, 그 디렉토리내의 모든 파일도 건네받습니다.

례:

     Map p = packer.properties();
     p.put(PASS_FILE_PFX+0, "mutants/Rogue.class");
     p.put(PASS_FILE_PFX+1, "mutants/Wolverine.class");
     p.put(PASS_FILE_PFX+2, "mutants/Storm.class");
     # Pass all files in an entire directory hierarchy:
     p.put(PASS_FILE_PFX+3, "police/");
 

관련 항목:

정수 필드값

UNKNOWN_ATTRIBUTE

static final String  UNKNOWN_ATTRIBUTE

불명한 속성을 포함한 클래스 파일에 조우했을 때에 실행하는 액션을 나타냅니다. 이용 가능한 값은 캐릭터 라인 ERROR, STRIP 및 PASS 입니다.

캐릭터 라인 ERROR 는 팩 조작이 전체적으로 실패해, 적절한 설명이 나타나는 것을의미합니다. 캐릭터 라인 STRIP 는 속성이 삭제되는 것을의미합니다. 캐릭터 라인 PASS 는 클래스 파일 전체가 (resource file와 같이) 압축없이 건네받아 적절한 경고가 나타나는 것을의미합니다. 이것이, 이 프로퍼티의 기본값 입니다.

례:

     Map p = pack200.getProperties();
     p.put(UNKNOWN_ATTRIBUTE, ERROR);
     p.put(UNKNOWN_ATTRIBUTE, STRIP);
     p.put(UNKNOWN_ATTRIBUTE, PASS);
 

관련 항목:

정수 필드값

CLASS_ATTRIBUTE_PFX

static final String  CLASS_ATTRIBUTE_PFX

클래스 속성명에 연결되었을 경우, JSR 200 사양으로 지정된 레이아웃 언어를 사용해, 그 속성의 형식을 나타냅니다.

예를 들어, pack.class.attribute.SourceFile=RUH에는 이 옵션의 효과가 삽입되어 있습니다.

특수한 캐릭터 라인 ERROR, STRIP 및 PASS 도, UNKNOWN_ATTRIBUTE 와 같은 미를 가지는 것으로서 허가되고 있습니다. 사용자는 이것을 사용하는 것으로 특정의 속성을 (클래스 압축없이) 비트 단위로 거부하거나 없애거나 건네주거나 할 수 있습니다.

다음과 같은 코드를 사용해, JCOV용의 속성을 지원 할 수 있습니다.

     Map p = packer.properties();
     p.put(CODE_ATTRIBUTE_PFX+"CoverageTable",       "NH[PHHII]");
     p.put(CODE_ATTRIBUTE_PFX+"CharacterRangeTable", "NH[PHPOHIIH]");
     p.put(CLASS_ATTRIBUTE_PFX+"SourceID",           "RUH");
     p.put(CLASS_ATTRIBUTE_PFX+"CompilationID",      "RUH");
 

다음과 같은 코드를 사용해, 디버그 속성을 없앨 수가 있습니다.

     Map p = packer.properties();
     p.put(CODE_ATTRIBUTE_PFX+"LineNumberTable",    STRIP);
     p.put(CODE_ATTRIBUTE_PFX+"LocalVariableTable", STRIP);
     p.put(CLASS_ATTRIBUTE_PFX+"SourceFile",        STRIP);
 

관련 항목:

정수 필드값

FIELD_ATTRIBUTE_PFX

static final String  FIELD_ATTRIBUTE_PFX

필드 속성명으로 연결해 사용되었을 경우, 속성의 형식을 나타냅니다. 예를 들어, pack.field.attribute.Deprecated=에는 이 옵션의 효과가 삽입되어 있습니다. 특수한 캐릭터 라인 ERROR, STRIP 및 PASS 도 사용할 수 있습니다.

관련 항목:

CLASS_ATTRIBUTE_PFX, 정수 필드값

METHOD_ATTRIBUTE_PFX

static final String  METHOD_ATTRIBUTE_PFX

메서드 속성명으로 연결해 사용되었을 경우, 속성의 형식을 나타냅니다. 예를 들어, pack.method.attribute.Exceptions=NH[RCH]에는 이 옵션의 효과가 삽입되어 있습니다. 특수한 캐릭터 라인 ERROR, STRIP 및 PASS 도 사용할 수 있습니다.

관련 항목:

CLASS_ATTRIBUTE_PFX, 정수 필드값

CODE_ATTRIBUTE_PFX

static final String  CODE_ATTRIBUTE_PFX

코드 속성명으로 연결해 사용되었을 경우, 속성의 형식을 나타냅니다. 예를 들어, pack.code.attribute.LocalVariableTable=NH[PHOHRUHRSHH]에는 이 옵션의 효과가 삽입되어 있습니다. 특수한 캐릭터 라인 ERROR, STRIP 및 PASS 도 사용할 수 있습니다.

관련 항목:

CLASS_ATTRIBUTE_PFX, 정수 필드값

PROGRESS

static final String  PROGRESS

unpacker 진척 상황을 퍼센트로 가리킵니다. 상황은 unpacker에 의해 주기적으로 갱신됩니다. 값 0 ~ 100 은 정상,-1 은 정체를 나타냅니다. PropertyChangeListener 와 함께 이 프로퍼티를 감시하도록의해 주세요.

unpacker는 최저한, 패킹 조작의 최초로 진척을 0 에 조작의 마지막에 진척을 100 으로 설정할 필요가 있습니다.

관련 항목:

addPropertyChangeListener(java.beans.PropertyChangeListener), 정수 필드값

KEEP

static final String  KEEP

캐릭터 라인 「keep」는 특정의 프로퍼티로 사용할 수 있습니다.

관련 항목:

DEFLATE_HINT, MODIFICATION_TIME, 정수 필드값

PASS

static final String  PASS

캐릭터 라인 「pass」는 특정의 프로퍼티로 사용할 수 있습니다.

관련 항목:

UNKNOWN_ATTRIBUTE, CLASS_ATTRIBUTE_PFX, FIELD_ATTRIBUTE_PFX, METHOD_ATTRIBUTE_PFX, CODE_ATTRIBUTE_PFX, 정수 필드값

STRIP

static final String  STRIP

캐릭터 라인 「strip」는 특정의 프로퍼티로 사용할 수 있습니다.

관련 항목:

UNKNOWN_ATTRIBUTE, CLASS_ATTRIBUTE_PFX, FIELD_ATTRIBUTE_PFX, METHOD_ATTRIBUTE_PFX, CODE_ATTRIBUTE_PFX, 정수 필드값

ERROR

static final String  ERROR

캐릭터 라인 「error」는 특정의 프로퍼티로 사용할 수 있습니다.

관련 항목:

UNKNOWN_ATTRIBUTE, CLASS_ATTRIBUTE_PFX, FIELD_ATTRIBUTE_PFX, METHOD_ATTRIBUTE_PFX, CODE_ATTRIBUTE_PFX, 정수 필드값

TRUE

static final String  TRUE

캐릭터 라인 「true」는 특정의 프로퍼티로 사용할 수 있습니다.

관련 항목:

KEEP_FILE_ORDER, DEFLATE_HINT, 정수 필드값

FALSE

static final String  FALSE

캐릭터 라인 「false」는 특정의 프로퍼티로 사용할 수 있습니다.

관련 항목:

KEEP_FILE_ORDER, DEFLATE_HINT, 정수 필드값

LATEST

static final String  LATEST

캐릭터 라인 「latest」는 특정의 프로퍼티로 사용할 수 있습니다.

관련 항목:

MODIFICATION_TIME, 정수 필드값

메서드의 상세

properties

SortedMap <String,
String > properties()

이 엔진의 프로퍼티 세트를 취득합니다. 이 세트는 「라이브뷰」이기 때문에 내용을 변경하면 즉시 Packer 엔진이 그 영향을 받습니다. 또, 엔진으로부터 행해진 변경 (진척의 표시등)은 즉시 맵으로 확인할 수 있습니다.

프로퍼티 맵에는 정의 끝난 구현 고유의 프로퍼티나 디폴트의 프로퍼티를 포함할 수 있습니다. 사용자는 기존의 프로퍼티를 변경하기 전에 정보를 확인해 미를 충분히 이해하는 것이 권유받고 있습니다.

구현 고유의 프로퍼티에는 com. 그리고 시작되는 구현자가 관련된 패키지명, 또는 유사한 접두사가 부가됩니다. pack. 및 unpack. 그리고 시작되는 모든 프로퍼티명은 이 API 용으로 예약되고 있습니다.

불명한 프로퍼티는 미지정의 에러로서 무시 또는 거부할 수 있습니다. 무효인 엔트리에의해 상세 불명 에러가 발생되는 경우가 있습니다.

리턴된 맵은 옵션 SortedMap를 모두 구현합니다.

반환값:

프로퍼티 키 캐릭터 라인과 프로퍼티치의, 소트된 관련짓고

pack

void pack(JarFile  in,
          OutputStream  out)
          throws IOException 

JarFile를 취득해, Pack200 어카이브(archive)로 변환합니다.

입력을 닫습니다만, 출력은 닫지 않습니다 (Pack200 어카이브(archive)는 추가 가능).

파라미터:

in - JarFile

out - OutputStream

예외:

IOException - 에러가 발생했을 경우

pack

void pack(JarInputStream  in,
          OutputStream  out)
          throws IOException 

JarInputStream를 취득해, Pack200 어카이브(archive)로 변환합니다.

입력을 닫습니다만, 출력은 닫지 않습니다 (Pack200 어카이브(archive)는 추가 가능).

JAR MANIFEST 파일 및 그것을 포함한 디렉토리에서 수정 시간 및 디플레이션 힌트 속성을 사용할 수 없습니다.

파라미터:

in - JarInputStream

out - OutputStream

예외:

IOException - 에러가 발생했을 경우

관련 항목:

MODIFICATION_TIME, DEFLATE_HINT

addPropertyChangeListener

void addPropertyChangeListener(PropertyChangeListener  listener)

PropertyChange 이벤트의 리스너를 프로퍼티 맵에 등록합니다. 보통, 이것은 어플리케이션에 의해 진척 바의 갱신에 사용됩니다.

파라미터:

listener - 프로퍼티의 변경시에 호출되는 객체

관련 항목:

properties(), PROGRESS

removePropertyChangeListener

void removePropertyChangeListener(PropertyChangeListener  listener)

addPropertyChangeListener(java.beans.PropertyChangeListener) 에 의해 추가된, PropertyChange 이벤트의 리스너를 삭제합니다.

파라미터:

listener - 삭제되는 PropertyChange 리스너

관련 항목:

addPropertyChangeListener(java.beans.PropertyChangeListener)