JSPBatchCompiler 명령

일괄처리 컴파일러는 JSP(JavaServer Pages)의 구문을 유효성 검증하고 JSP 페이지를 Java™ 소스 파일로 변환하고 Java 소스 파일을 Java 서블릿 클래스 파일에 컴파일합니다. 일괄처리 컴파일러는 태그 파일을 유효성 검증하고 Java 구현 클래스를 생성합니다. 이 기능을 사용하면 JSP 파일을 일괄처리 컴파일할 수 있으며 프로덕션 웹 서버의 JSP 파일에 대한 초기 클라이언트 요청에 더 빠른 응답이 가능합니다.

일괄처리 컴파일러는 압축되거나 확장된 엔터프라이즈 아카이브(EAR) 파일 및 웹 애플리케이션 아카이브(WAR) 파일, WebSphere® Application Server에 배치된 엔터프라이즈 애플리케이션 및 웹 모듈에 대해 실행될 수 있습니다. 대상이 배치된 엔터프라이즈 애플리케이션일 때, 서버는 일괄처리 컴파일러를 실행하기 위해 실행 중일 필요가 없습니다. 일괄처리 컴파일러가 대상 서버가 실행되는 동안 실행될 경우, 서버가 업데이트된 클래스 파일을 인식하지 못하여 엔터프라이즈 애플리케이션이 다시 시작되기 전에는 해당 클래스 파일을 로드하지 못합니다. 대상이 압축된 EAR 파일 또는 WAR 파일일 때, 일괄처리 컴파일러는 실행하기 전에 이를 확장해야 합니다.

웹 모듈의 처리

일괄처리 컴파일러는 동시에 한 웹 모듈에 작용합니다. 대상이 둘 이상의 웹 모듈을 포함하는 설치된 엔터프라이즈 애플리케이션 또는 EAR 파일 중 하나인 경우, 일괄처리 컴파일러는 각 웹 모듈에서 개별적으로 작동합니다. 이는 JSP 페이지가 웹 모듈의 web.xml 배치 디스크립터 파일을 통해 웹 모듈을 기준으로 구성되기 때문입니다. 웹 모듈 내에서 일괄처리 컴파일러는 한 번에 하나의 디렉토리를 처리합니다. 이는 각 JSP 페이지를 개별적으로 유효성 검증하고 변환한 다음 해당 디렉토리에서 생성된 Java 소스 파일의 전체 그룹에 대한 Java 컴파일러를 호출합니다. Java 컴파일 단계 동안 하나의 JSP 페이지가 실패하면 Java 컴파일러는 해당 디렉토리에 성공적으로 컴파일한 대부분 또는 모든 JSP 페이지에 대한 클래스 파일을 작성하지 않을 수 있습니다.

JSP 파일 확장자

일괄처리 컴파일러는 처리해야 하는 파일 확장자를 판별하기 위해 네 가지를 사용합니다.
  1. 표준 JSP 파일 확장자
    • .jsp
    • .jspx
    • .jsw
    • .jsv
  2. 서블릿 2.4 웹 모듈의 배치 디스크립터 파일에서 JSP 특성 그룹 요소의 URL 패턴 특성
  3. jsp.file.extensions JSP 엔진 구성 매개변수(이전 서블릿 2.4 웹 모듈의 경우)
  4. 일괄처리 컴파일러 구성 매개변수 jsp.file.extensions

표준 확장자는 일괄처리 컴파일러에 의해 항상 사용됩니다. 웹 모듈에 서블릿 2.4 배치 디스크립터가 포함되면 일괄처리 컴파일러는 jsp-config 요소 내에서 발견되는 URL 패턴도 처리합니다. 일괄처리 컴파일러 대상에 JSP 엔진 구성 매개변수 jsp.file.extensions가 포함되면 해당 확장자도 처리됩니다. 일괄처리 컴파일러 구성 매개변수 jsp.file.extensions가 있을 경우, 지정된 확장자도 처리되고 해당 확장자가 JSP 엔진 구성 매개변수 jsp.file.extensions를 대체합니다.

JSP '단편'에 일괄처리 컴파일러에 의해 처리되지 않는 확장자를 제공하는 것이 좋습니다. 독립형이 아닌 정적으로 포함된 단편은 처리되는 경우 변환 또는 컴파일 오류를 생성합니다. JSP 2.0 스펙은 그러한 파일에 대해 확장자 .jspf를 사용할 것을 제안합니다.

일괄처리 컴파일러 명령

[AIX Solaris HP-UX Linux Windows][z/OS]명령행으로부터 일괄처리 컴파일러를 실행하기 위한 Windows 일괄처리 파일, JspBatchCompiler.bat 및 UNIX 쉘 스크립트 JspBatchCompiler.sh 모두가 {WAS_ROOT}/bin 디렉토리에서 발견됩니다. Ant 태스크는 Ant를 사용하여 일괄처리 컴파일러를 실행하기 위해 사용할 수도 있습니다. 추가 정보는 일괄처리 컴파일러 Ant 태스크 주제를 참조하십시오.

[IBM i]Qshell 명령행에서 일괄처리 컴파일러를 실행하기 위한 JspBatchCompiler 스크립트가 app_server_root/bin 디렉토리에서 발견됩니다. Ant 태스크는 Ant를 사용하여 일괄처리 컴파일러를 실행하기 위해 사용할 수도 있습니다. 추가 정보는 일괄처리 컴파일러 Ant 태스크 주제를 참조하십시오.

일괄처리 컴파일러 대상은 유일한 필수 매개변수입니다. 대상은 -ear.path, -war.path 또는 -enterpriseapp.name 중 하나입니다.
JspBatchCompiler -ear.path | -war.path | -enterpriseapp.name <name>
			[-response.file <filename>]
			[-webmodule.name <name>]
			[-filename <jsp name | directory name>
			[-recurse <true | false>]
			[-config.root <path>]
			[-cell.name <name>]
			[-cluster.name <name>]			[-node.name <name>]
			[-server.name <name>]
			[-profileName <name>]
			[-extractToDir <path>]
			[-compileToDir <path>]
			[-compileToWebInf <true | false>]
      [-compileToWebInf <true | false>]
      [-compileAfterFailure <true | false>]
			[-translate <true | false>]
			[-compile <true | false>]
			[-removeTempDir <true | false>]
			[-forceCompilation <true | false>]
			[-useFullPackageNames <true | false>]
			[-trackDependencies <true | false>]
			[-createDebugClassfiles <true | false>]
			[-keepgenerated <true | false>]
			[-keepGeneratedclassfiles <true | false>]
			[-usePageTagPool <true | false>]
			[-useThreadTagPool <true | false>]
			[-classloader.parentFirst <true | false>]
			[-classloader.singleWarClassloader <true | false>]
			[-additional.classpath <classpath to additional JAR files and classes>]
					
			[-verbose <true | false>]
			[-deprecation <true | false>]
			[-javaEncoding <encoding>
			[-jdkSourceLevel <13 | 14 | 15 | 16 | 17 | 18 >]			
			[-compilerOptions <space-separated list of java compiler options>]
			[-useJikes <true | false>]
			[-jsp.file.extensions <file extensions to process>]
			[-log.level <SEVERE | WARNING | INFO | CONFIG | FINE | FINER | FINEST | OFF>]
[AIX Solaris HP-UX Linux Windows][z/OS]
			*** See batchcompiler.properties.default in WAS_ROOT/bin for more information. ***
  	*** See JspCBuild.xml in WAS_ROOT/bin for information about the public WebSphere Ant task JspC. ***
[IBM i]
			*** See batchcompiler.properties.default in app_server_root/bin for more information. ***
   *** See JspCBuild.xml in app_server_root/bin for information about the public WebSphere Ant task JspC. ***
일괄처리 컴파일러는 구성 매개변수의 세 개의 그룹을 인식합니다.
  1. 웹 모듈에 대한 JSP 엔진 구성 매개변수.

    JSP 엔진 구성 매개변수 주제를 참조하십시오.

  2. 일괄처리 컴파일러 응답 파일 구성 매개변수.

    이는 일괄처리 컴파일러 응답 파일에서 발견되는 매개변수입니다. -response.file을 참조하십시오.

  3. 일괄처리 컴파일러 명령행 구성 매개변수.

    이는 일괄처리 컴파일러를 실행할 때 명령행에 입력된 매개변수입니다.

일괄처리 컴파일러는 JSP 페이지를 컴파일할 때 사용되는 매개변수의 값을 결정하기 위해 세 개의 구성 매개변수 그룹을 모두 검토합니다. 지정된 매개변수에 대한 값을 해결할 때 우선순위는 다음과 같습니다.
  1. 매개변수가 명령행에서 발견되면 해당 값이 사용됩니다.
  2. 매개변수가 명령행에서 발견되지 않으면 일괄처리 컴파일러는 명령행의 이름 지정된 응답 파일에서 매개변수를 찾습니다.
  3. 응답 파일에 이름이 지정되지 않거나 그 안에서 매개변수가 발견되지 않으면 일괄처리 컴파일러는 웹 모듈의 JSP 엔진 구성 매개변수를 찾습니다.

구성 매개변수가 이러한 세 개의 그룹에서 발견되지 않으면 기본값이 사용됩니다. 구성 매개변수에 대한 기본값이 매개변수의 설명과 함께 제공됩니다.

하나의 예외로 이러한 매개변수는 대소문자 구분이 아닙니다. -profileName은 대소문자 구분입니다. 이러한 인수에 지정된 값이 공백으로 구분되는 둘 이상의 단어로 구성되면 값 주위에 따옴표를 추가해야 합니다.

일괄처리 컴파일러가 동등한 JSP 엔진 매개변수를 작성하지 않거나 이의 값을 설정하지 않습니다. 이는 배치된 웹 모듈의 JSP 페이지가 수정되고 런타임 시 JSP 엔진에 의해 재컴파일되면 JSP 엔진의 구성 매개변수가 엔진의 동작을 판별한다는 것을 의미합니다. 예를 들어, 일괄처리 컴파일러를 사용하여 웹 모듈을 컴파일하고 -useFullPackageNames true 옵션을 사용하면 JSP 파일은 해당 옵션을 지원하기 위해 컴파일됩니다. 그러나 JSP 엔진 매개변수 useFullPackageNames는 JSP 런타임이 컴파일된 JSP 페이지를 로드할 수 있도록 하기 위해 true로 설정되어야 합니다. JSP 페이지가 배치된 웹 모듈에서 수정되면 엔진의 매개변수가 일괄처리 컴파일러에서 사용되는 동일한 값으로 설정되어야 합니다.

JSP 일괄처리 컴파일러를 사용하려면 운영 체제 명령 프롬프트의 한 행에 다음 명령 중 하나를 입력하십시오.

  • ear.path | war.path | enterpriseapp.name
    단일 압축되거나 확장된 엔터프라이즈 애플리케이션 아카이브(EAR) 파일 또는 웹 애플리케이션 아카이브(WAR), 혹은 컴파일하려는 배치된 엔터프라이즈 애플리케이션의 이름에 전체 경로를 나타냅니다. 예를 들어 다음과 같습니다.
    • [AIX Solaris HP-UX Linux Windows]JspBatchCompiler -ear.path c:\myproject\sampleApp.ear
    • [z/OS]JspBatchCompiler -ear.path /myhfs/myprojects/sampleApp.ear
    • [AIX Solaris HP-UX Linux Windows][z/OS]JspBatchCompiler -war.path c:\myWars\examples.war
    • [AIX Solaris HP-UX Linux Windows][z/OS]JspBatchCompiler -enterpriseapp.name myEnterpriseApp -webmodule.name my.war -filename aDir/main.jsp
    • [IBM i]JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear
    • [IBM i]JspBatchCompiler -war.path /home/wasuser/wars/examples.war
    • [IBM i]JspBatchCompiler -enterpriseapp.name myEnterpriseApp -webmodule.name my.war -filename mydirectory/main.jsp
  • response.file

    일괄처리 컴파일러에서 사용하는 구성 매개변수를 포함하는 파일에 경로를 지정합니다. response.file은 명령행에서 지정되는 경우에만 사용됩니다. 이는 응답 파일에 존재하는 경우에 무시됩니다.

    [AIX Solaris HP-UX Linux Windows][z/OS]기본 설치에서 템플리트 응답 파일(batchcompiler.properties.default)이 {WAS_ROOT}/bin 디렉토리에서 발견됩니다. 관심 있는 매개변수에 대한 기본값을 포함하는 자체 응답 파일을 작성하려면 이 템플리트를 복사하십시오. 모든 필수 및 선택적 매개변수(response.file 제외)가 응답 파일에서 구성될 수 있습니다. 예: JspBatchCompiler -response.file c:\myproject\batchc.props

    [IBM i]템플리트 응답 파일(batchcompiler.properties.default)이 app_server_root/properties 디렉토리에서 발견됩니다. 관심 있는 매개변수에 대한 기본값을 포함하는 자체 응답 파일을 작성하려면 이 템플리트를 복사하십시오. 응답 파일에서 response.file을 제외하고 모든 필수 및 선택적 매개변수를 구성할 수 있습니다(예: JspBatchCompiler -response.file /home/wasuser/myproject/batchc.props).

    기본: null

  • webmodule.name

    컴파일을 일괄처리하려는 특정 웹 모듈의 이름을 나타냅니다. 이 인수가 설정되지 않으면 엔터프라이즈 애플리케이션의 모든 웹 모듈이 컴파일됩니다. 이 매개변수는 ear.path 또는 enterpriseapp.name이 지정될 때에만 사용됩니다. 모든 공유 라이브러리 종속 항목이 선택되므로 이 매개변수는 배치된 엔터프라이즈 애플리케이션 내의 특성 웹 모듈에 있는 JSP 페이지가 재생성되어야 할 때 유용합니다.

    예: JspBatchCompiler -enterpriseApp.name sampleApp -webmodule.name myWebModule.war

    기본: 이 매개변수가 지정되지 않으면 EAR 파일 또는 엔터프라이즈 애플리케이션의 모든 웹 모듈이 컴파일됩니다.

  • filename

    컴파일하려는 단일 JSP 파일의 이름을 나타냅니다. 이 인수가 설정되지 않으면 웹 모듈의 모든 파일이 컴파일됩니다. 그렇지 않으면, filename이 디렉토리의 이름으로 설정되면 해당 디렉토리 및 해당 디렉토리의 하위 디렉토리의 JSP 파일만 컴파일됩니다. 이름은 웹 모듈의 컨텍스트 루트에 상대적입니다.

    예제 1: 파일(myTest.jsp)을 컴파일하려 하고 /subdir/myJSPs에서 발견되는 경우, -filename /subdir/myJSPs/myTest.jsp를 입력하십시오.

    예제 2: /subdir/myJSPs 및 하위 디렉토리에서 모든 JSP 파일을 컴파일하려는 경우, -filename subdir/myJSPs를 입력하십시오.

    기본: 웹 모듈의 모든 JSP 파일이 컴파일됩니다. -filename /를 입력하는 것은 기본값과 동일합니다.

  • recurse

    대상 디렉토리 아래의 서브디렉토리가 처리되는지 여부를 판별합니다. 이 매개변수는 filename 매개변수가 지정될 때에만 사용됩니다. 서브디렉토리가 아닌 filename 매개변수라는 디렉토리만 처리하려면 값을 false로 설정십시오.

    예: JspBatchCompiler -enterpriseApp.name sampleApp -filename /subdir1 -recurse false.

    기본: true. 대상 디렉토리 아래의 모든 디렉토리가 처리됩니다.

  • config.root

    WebSphere Application Server 구성 디렉토리의 위치를 지정합니다. 이 매개변수는 enterpriseapp.name이 지정될 때에만 사용됩니다.

    [AIX Solaris HP-UX Linux Windows][z/OS]기본: {WAS_ROOT}/profiles/profilename/config

    [IBM i]기본: profile_root/config

  • cell.name

    애플리케이션이 배치되는 셀의 이름을 지정합니다. 이 매개변수는 enterpriseapp.name이 지정될 때에만 사용됩니다.

    기본: 기본값은 사용되는 프로파일 스크립트에서 획득됩니다. 이 변수의 기호 이름은 WAS_CELL입니다.

  • cluster.name

    애플리케이션이 배치되는 클러스터의 이름을 지정합니다. 이 매개변수는 클러스터 범위 공유 라이브러리에 대한 액세스에 일괄처리 컴파일러를 제공하고 enterpriseapp.name이 지정될 때에만 사용됩니다.

    기본: 기본값은 사용되는 프로파일 스크립트에서 획득됩니다. 이 변수의 기호 이름은 WAS_CLUSTER입니다.

  • node.name

    애플리케이션이 전개되는 노드의 이름을 지정합니다. 이 매개변수는 enterpriseapp.name이 지정될 때에만 사용됩니다.

    기본: 기본값은 사용되는 프로파일 스크립트에서 획득됩니다. 이 변수의 기호 이름은 WAS_NODE입니다.

  • server.name

    애플리케이션이 배치되는 서버의 이름을 나타냅니다. 이 매개변수는 enterpriseapp.name이 지정될 때에만 사용됩니다.

    기본: server1

  • profileName

    사용하려는 프로파일의 이름을 지정합니다. 이 매개변수는 enterpriseapp.name 또는 -ear 경로가 지정될 때에만 사용됩니다.

    예: JspBatchCompiler -enterpriseApp.name sampleApp -profileName AppServer-3

    [AIX Solaris HP-UX Linux Windows][z/OS]기본: 기본 프로파일이 사용됩니다. 이는 install_root/bin 디렉토리에서 파일 setupCmdLine 스크립트로부터 획득됩니다. 기호 이름은 DEFAULT_PROFILE_SCRIPT입니다.

    [IBM i]기본: 기본 프로파일이 사용됩니다. 이는 app_server_root/bin 디렉토리에서 파일 setupCmdLine 스크립트로부터 획득됩니다. 기호 이름은 DEFAULT_PROFILE_SCRIPT입니다.

  • extractToDir

    일괄처리 컴파일러가 파일에서 작동하기 전 추출되는 사전 배치된 엔터프라이즈 아카이브(EAR) 파일 및 웹 애플리케이션 아카이브(WAR) 파일에 디렉토리를 지정합니다. 이 매개변수는 enterpriseapp.name이 지정될 때 무시됩니다.extractToDir 매개변수는 테이블에 설명된 대로 사용됩니다.

    [AIX Solaris HP-UX Linux Windows][z/OS]예: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -extractToDir c:\myTempDir.

    [IBM i]예: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -extractToDir /home/wasuser/mytempdir.

    유스 케이스: 일괄처리 컴파일되기 전에 압축된 아카이브를 추출해야 합니다. 새 디렉토리로도 확장된 아카이브를 추출할 수 있습니다. 양쪽 모두의 경우, 추출은 원래 아카이브를 변경되지 않은 상태로 남겨두며, 이는 개발이 진행 중인 동안에 유용할 수도 있습니다.

    표 1. extractToDir . 기본값
      확장된 아카이브 압축된 아카이브
    extractToDir은 제공됨 일괄처리 컴파일러는 작동하기 전에 extractToDir에 아카이브를 추출합니다. 아카이브와 동일한 이름의 파일 또는 디렉토리가 extractToDir에 이미 존재하면 일괄처리 컴파일러는 해당 아카이브를 추출하기 전에 완전히 아카이브를 제거합니다. 일괄처리 컴파일러가 오류 없이 존재하면 원래 EAR 파일 또는 WAR 파일이 확장되는 경우에도 extractToDir에서 아카이브를 압축합니다. 컴파일 동안 오류가 발생하면 원래 EAR 파일 또는 WAR 파일이 압축된다고 해도 EAR 파일 또는 WAR 파일이 확장된 상태가 됩니다.
    extractToDir은 제공되지 않음 일괄처리 컴파일러는 실행 중인 EAR 파일 또는 WAR 파일에서 작동하고(다른 디렉토리로 추출하지 않음) 아카이브는 일괄처리 컴파일러가 종료된 후 확장된 채로 남아 있습니다. 일괄처리 컴파일러는 JVM 특성 "java.io.tmpdir"에 의해 리턴되는 디렉토리로 아카이브를 추출합니다. extractToDir이 제공된 경우 설명된 나머지 동작은 이 경우와 동일합니다.

    기본값은 server1입니다.

  • compileToDir

    Java 소스 파일로 변환되고 클래스 파일로 컴파일되는 JSP 페이지에 디렉토리를 지정합니다. 이 디렉토리는 파일 시스템 상의 어느 위치에도 있을 수 있지만, 일반적으로 일괄처리 컴파일러의 기본 동작이 적합합니다. 클래스 파일을 컴파일할 때 일괄처리 컴파일러의 동작이 테이블에 설명됩니다.

    [AIX Solaris HP-UX Linux Windows][z/OS]예:: JspBatchCompiler -enterpriseApp.name sampleApp -compileToDir c:\myTargetDir

    [IBM i]예:: JspBatchCompiler -enterpriseApp.name sampleApp -compileToDir /home/wasuser/myTargetDir

    유스 케이스: 이 매개변수를 사용하면 Java 및 클래스 파일을 대상 외부 디렉토리에 생성할 수 있으며 이는 새로 생성된 파일과 대상 내부에서 변경되지 않은 상태로 남아 있는 이전 버전의 파일을 비교하려는 경우 유용합니다.

    [AIX Solaris HP-UX Linux Windows][z/OS]
    표 2. compileToDir . 기본값
      ear.path 또는 war.path가 제공됨 enterpriseApp.name이 제공됨
    compileToDir은 제공되지 않습니다. compileToWebInf가 제공되지 않고 true입니다. 클래스 파일은 웹 모듈의 WEB-INF/classes 디렉토리로 컴파일됩니다. 클래스 파일은 웹 모듈의 WEB-INF/classes 디렉토리로 컴파일됩니다.
    compileToDir은 제공되지 않습니다. compileToWebInf는 false입니다. 클래스 파일은 웹 모듈의 WEB-INF/classes 디렉토리로 컴파일됩니다. 클래스 파일은 제품 임시 디렉토리(일반적으로 {WAS_ROOT}/temp)로 컴파일됩니다.
    compileToDir이 제공됩니다. compileToWebInf는 제공되지 않고 true 또는 false입니다. 클래스 파일은 compileToDir에 의해 표시되는 디렉토리로 컴파일됩니다. 클래스 파일은 compileToDir에 의해 표시되는 디렉토리로 컴파일됩니다.
    [IBM i]
    표 3. compileToDir . 기본값
      ear.path 또는 war.path가 제공됨 enterpriseApp.name이 제공됨
    compileToDir은 제공되지 않습니다. compileToWebInf가 제공되지 않고 true입니다. 클래스 파일은 웹 모듈의 WEB-INF/classes 디렉토리로 컴파일됩니다. 클래스 파일은 웹 모듈의 WEB-INF/classes 디렉토리로 컴파일됩니다.
    compileToDir은 제공되지 않습니다. compileToWebInf는 false입니다. 클래스 파일은 웹 모듈의 WEB-INF/classes 디렉토리로 컴파일됩니다. 클래스 파일은 제품 임시 디렉토리(일반적으로 profile_root/temp)로 컴파일됩니다.
    compileToDir이 제공됩니다. compileToWebInf는 제공되지 않고 true 또는 false입니다. 클래스 파일은 compileToDir에 의해 표시되는 디렉토리로 컴파일됩니다. 클래스 파일은 compileToDir에 의해 표시되는 디렉토리로 컴파일됩니다.
  • compileToWebInf

    컴파일된 JSP 클래스 파일에 대한 대상 디렉토리가 웹 모듈의 WEB-INF/classes 디렉토리에 있어야 하는지 여부를 지정합니다. 이 매개변수는 enterpriseApp.name이 지정될 때에만 사용되고 이는 compileToDir이 지정되는 경우 compileToDir에 의해 대체됩니다.

    일괄처리 컴파일러의 기본 동작은 웹 모듈의 WEB-INF/classes 디렉토리에 컴파일하는 것입니다. 클래스 파일을 컴파일할 때 일괄처리 컴파일러의 동작이 설명됩니다.

    예: JspBatchCompiler -enterpriseApp.name sampleApp -compileToWebInf false.

    유스 케이스: enterpriseApp.name이 제공되고 웹 모듈의 WEB-INF/classes 디렉토리 대신 WebSphere Application Server 임시 디렉토리로 클래스 파일을 컴파일하려는 경우 이 매개변수를 false로 설정하십시오. 권장사항: 이 매개변수가 false로 설정되면 WEB-INF/classes 디렉토리에 JSP 클래스 파일이 있는 경우 forceCompilation을 true로 설정하십시오.

    기본: true. 테이블을 참조하십시오.

  • compileAfterFailure

    해당 디렉토리에서 하나 이상의 JSP(JavaServer Pages) 파일을 컴파일할 수 없으면 현재 디렉토리에서 기타 JSP(JavaServer Pages) 파일을 계속 컴파일하는지 여부를 지정합니다. 일반적으로 파일 중 하나를 컴파일할 수 없을 때, JSP 일괄처리 컴파일러는 해당 디렉토리에서 모든 남아 있는 JSP를 건너뛰고 다음 디렉토리에서 파일을 컴파일하기 시작합니다.

    이 매개변수를 true로 설정하면 useJDKCompiler 매개변수를 지정하고 해당 매개변수를 true로 설정해야 합니다.

    예: JspBatchCompiler -enterpriseApp.name sampleApp -useJDKCompiler true –compileAfterFailure false.

    유스 케이스: 해당 디렉토리에서 하나 이상의 JSP 파일을 컴파일할 수 없을지라도 현재 디렉토리에서 JSP 일괄처리 컴파일러가 기타 JSP(JavaServer Pages) 파일을 컴파일하려는 경우 이 매개변수를 true로 설정하십시오.

    기본값: false

  • forceCompilation

    일괄처리 컴파일러는 이와 상관 없이 모든 JSP 자원을 재컴파일하도록 강제 실행되는지 여부 또는 JSP 페이지가 업데이트되는지 여부를 지정합니다.

    [AIX Solaris HP-UX Linux Windows][z/OS]예: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -forceCompilation true.

    [IBM i]예: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -forceCompilation true.

    유스 케이스: 모든 JSP 클래스가 업데이트되는지 확인하기 위해 배치를 위한 아카이브를 작성할 때 특히 유용합니다.

    기본값: false

  • useFullPackageNames

    일괄처리 컴파일러가 JSP 클래스에 대한 전체 패키지 이름을 생성하는지 여부를 지정합니다. 기본은 동일한 패키지에서 모든 JSP 클래스를 생성하는 것입니다. JSP 엔진의 클래스 로더는 JSP 클래스가 모두 동일한 패키지에 있을 때 해당 클래스를 로드하는 방법을 인식합니다. 기본값에는 더 작은 파일 시스템 경로를 생성하는 이점이 있습니다. 전체 패키지 이름에는 jsp-file 속성을 사용하지 않고 web.xml 파일에서 서블릿으로 사전 컴파일된 JSP 클래스 파일의 구성을 사용할 수 있는 이점이 있습니다. 이는 결과적으로 그런 모든 JSP 클래스를 로그하기 위해 사용되는 단일 클래스 로더(웹 애플리케이션의 클래스 로더)입니다. 유사하게, JSP 엔진의 구성 속성 useFullPackageNamesdisableJspRuntimeCompilation이 모두 true일 때, JSP 페이지가 web.xml 파일에서 서블릿으로 구성되지 않는다고 해도 단일 클래스 로더는 모든 JSP 클래스를 로그하기 위해 사용됩니다.

    useFullPackageNames가 true로 설정될 때, 일괄처리 컴파일러는 웹 모듈의 WEB-INF 디렉토리에 generated_web.xml이라고 하는 파일을 생성합니다. 이 파일에는 성공적으로 변환되고 컴파일된 각 JSP 페이지에 대한 서블릿 구성 정보가 포함됩니다. 정보는 선택적으로 JSP 페이지가 웹 컨테이너에 의해서 서블릿으로 로드되도록 웹 모듈의 web.xml 파일로 복사될 수 있습니다. JSP 페이지가 이 방법으로 서블릿으로서 구성되면 JSP 페이지의 로딩은 JSP 페이지가 수정되면 런타임 시 수행됩니다. 이는 JSP 페이지가 일반 서블릿으로 처리되고 이에 대한 요청이 JSP 엔진을 통해 전달되지 않기 때문입니다.

    예: JspBatchCompiler –enterpriseApp.name sampleApp –useFullPackageNames true

    유스 케이스: 단일 클래스 로더에 의해 로딩되도록 JSP 클래스를 사용합니다.

    기본값: false

  • removeTempDir

    웹 모듈의 임시 디렉토리가 제거되는지 여부를 지정합니다. 기본적으로 일괄처리 컴파일러는 웹 모듈의 WEB-INF/classes 디렉토리에서 JSP 클래스 파일을 생성합니다. JSP 클래스 파일은 JSP 페이지가 수정되고 JSP 다시 로드가 사용되면 런타임 시 temp 디렉토리에서 생성됩니다. 웹 모듈에서 모든 JSP 페이지를 일괄처리 컴파일하고 temp 디렉토리를 제거하여 디스크 자원이 유지됩니다. -enterpriseApp.name이 지정될 때 removeTempDir 매개변수도 사용할 수 있습니다.

    예: JspBatchCompiler -enterpriseApp.name sampleApp -removeTempDir true.

    유스 케이스: 웹 애플리케이션의 temp 디렉토리를 선택 취소하여 디스크 공간을 확보하십시오.

    기본값: false

  • translate

    JSP 페이지가 변환되고 컴파일되는지 여부를 지정합니다. JSP 페이지가 변환되고 컴파일되도록 원하지 않으면 변환을 false로 설정하십시오. -removeTempDir과 함께 이 옵션을 사용하여 유일한 temp 디렉토리를 제거하고 추가 처리를 수행하지 않도록 일괄처리 컴파일러에 전달해야 합니다.

    예: JspBatchCompiler -enterpriseApp.name sampleApp -translate false -removeTempDir true.

    유스 케이스: JSP 처리를 호출하지 않고 웹 애플리케이션의 temp 디렉토리를 선택 취소하여 디스크 공간을 확보하십시오.

    기본: true

  • compile

    JSP 페이지가 Java 컴파일 단계를 통과하는지 여부를 지정합니다. JSP 페이지가 Java 컴파일 단계를 통과하도록 하지 않으려면 컴파일을 false로 설정하십시오.

    예: JspBatchCompiler -enterpriseApp.name sampleApp -compile false

    유스 케이스: JSP 페이지가 구문 확인되도록 하려는 경우, -compile을 false로 설정하십시오. 변환 단계 동안 생성되는 .java 파일을 보려는 경우 -keepgenerated를 true로 설정할 수 있습니다.

    기본: true

  • trackDependencies
    JSP 페이지 자체가 변경되지 않는다 해도 해당 종속 항목이 변경될 때 일괄처리 컴파일러가 JSP 페이지를 재컴파일할지 여부를 지정합니다. 해당 종속 항목이 변경되는지 여부를 보기 위해 JSP 엔진이 모든 요청에서 JSP 페이지에 대한 파일 시스템을 검사하므로 종속 항목 추적은 중요한 런타임 성능 패널티를 초래합니다. WebSphere Application Server에 의해 추적되는 종속 항목은 다음과 같습니다.
    1. JSP 페이지에 정적으로 포함되는 파일
    2. JSP 페이지에 의해 사용되는 태그 파일(JAR 파일에 있는 태그 파일 제외)
    3. JSP 페이지에 의해 사용되는 TLD 파일(JAR 파일에 있는 TLD 파일 제외)

    [AIX Solaris HP-UX Linux Windows][z/OS]예: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -trackDependencies true.

    [IBM i]예: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -trackDependencies true.

    유스 케이스: 배치 환경에서 유용합니다.

    기본값: false

  • createDebugClassfiles

    일괄처리 컴파일러가 기타 언어에 대한 디버깅 지원인 JSR 45에 따라 SMAP 정보를 포함하는 클래스 파일을 생성하는지 여부를 지정합니다.

    예: JspBatchCompiler -enterpriseApp.name sampleApp -createDebugClassfiles true

    유스 케이스: JSR 45 준수 IDE에서 JSP 페이지를 디버그할 수 있도록 하려고 할 때 이 매개변수를 사용하십시오.

    기본값: false

  • keepgenerated

    변환 단계 동안 작성된 일괄처리 컴파일러가 생성된 Java 소스 파일을 저장하거나 지우는지 여부를 지정합니다.

    true로 설정되면 WebSphere Application Server는 서버에서 컴파일에 사용되는 생성된 .java 파일을 저장합니다. 기본적으로, 이 인수는 false로 설정되고 .java 파일이 클래스 파일이 컴파일된 후 지워집니다.

    [AIX Solaris HP-UX Linux Windows][z/OS]예: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -keepgenerated true

    [IBM i]예: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -keepgenerated true

    유스 케이스: 일괄처리 컴파일러에서 생성되는 Java 코드를 검토하려고 할 때 이 매개변수를 사용하십시오.

    기본값: false

  • keepGeneratedclassfiles

    일괄처리 컴파일러는 Java 소스 파일의 컴파일 동안 생성된 클래스 파일을 저장하거나 지우는지 여부를 지정합니다.

    [AIX Solaris HP-UX Linux Windows][z/OS]예: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -keepGeneratedclassfiles false -keepgenerated false

    [IBM i]예: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -keepGeneratedclassfiles false -keepgenerated false

    유스 케이스: JSP 페이지에 변환 또는 컴파일 오류가 있는지 여부를 보려는 경우에만 이 매개변수를 false로 설정하십시오. -keepgenerated false와 쌍을 이루는 경우, 이 매개변수를 사용하면 일괄처리 컴파일러가 완료되기 전에 생성된 모든 파일이 제거됩니다.

    기본: true

  • usePageTagPool

    개별 JSP 페이지 기초에서 사용자 정의 태그 핸들러의 재사용을 사용하거나 사용하지 않습니다.

    [AIX Solaris HP-UX Linux Windows][z/OS]예: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -usePageTagPool true

    [IBM i]예: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -usePageTagPool true

    유스 케이스: 이 매개변수를 사용하여 태그 핸들러의 JSP 페이지 기반 재사용을 사용하십시오.

    기본값: false

  • useThreadTagPool

    웹 모듈당 요청 스레드 기초 마다 사용자 정의 태그 핸들러의 재사용을 사용하거나 사용하지 않습니다.

    [AIX Solaris HP-UX Linux Windows][z/OS]예: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -useThreadTagPool true

    [IBM i]예: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -useThreadTagPool true

    유스 케이스: 이 매개변수를 사용하여 태그 핸들러의 웹 모듈 기반 재사용을 사용하십시오.

    기본값: false

  • classloader.parentFirst

    애플리케이션 클래스 로더 이전에 상위 클래스 로더를 검색하도록 일괄처리 컴파일러를 지시하여 클래스를 로딩하기 위한 검색 순서를 지정합니다. 이 매개변수는 ear.path 또는 enterpriseApp.name이 지정될 때에만 사용됩니다.

    [AIX Solaris HP-UX Linux Windows][z/OS]예: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -classloader.parentFirst false

    [IBM i]예: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -classloader.parentFirst false

    유스 케이스: 웹 모듈이 서버 LIB 디렉토리에서 발견되는 JAR 파일을 포함하고 웹 모듈의 JAR 파일이 먼저 선택되도록 하려고 할 때 이 매개변수를 false로 설정하십시오.

    기본: true

  • classloader.singleWarClassloader

    엔터프라이즈 아카이브(EAR) 파일당 하나의 클래스 로더를 사용하는지 또는 웹 애플리케이션 아카이브(WAR) 파일당 하나의 클래스 로더를 사용하는지 여부를 지정합니다. ear.path 또는 enterpriseApp.name이 지정될 때에만 사용됩니다.

    [AIX Solaris HP-UX Linux Windows][z/OS]예: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -classloader.singleWarClassloader true

    [IBM i]예: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -classloader.singleWarClassloader true

    유스 케이스: 웹 모듈이 동일한 엔터프라이즈 애플리케이션에 있는 다른 웹 모듈의 JAR 파일 및 클래스에 따라 다를 때 이 매개변수를 true로 설정하십시오.

    기본: false. 기타 웹 모듈에서 클래스의 가시성이 없이 WAR 파일마다 하나의 클래스 로더가 작성됩니다.

  • additional.classpath

    JSP 페이지를 구문 분석하고 컴파일할 때 사용될 추가 클래스 경로 항목을 지정합니다. 이 매개변수는 war.path가 지정될 때에만 사용됩니다. war.path가 대상일 때, WebSphere Shared Libraries는 일괄처리 컴파일러에 의해 선택되지 않습니다. 따라서, 예를 들어 WAR 파일이 공유 라이브러리로 WebSphere Application Server에 구성되는 JAR 파일에 의존하는 경우에는 이 옵션을 사용하여 해당 JAR 파일을 가리키십시오. 또한, war.path를 제공하고 -extractToDir 매개변수를 사용하는 경우, WAR 파일의 Manifest 클래스 경로에 있는 JAR 파일이 클래스 경로에 추가되지 않습니다(WAR 파일이 상주하는 EAR 파일 외부에서 자체적으로 추출되기 때문임). 이 경우 -additional.classpath를 사용하여 필수 JAR 파일을 가리키십시오. 시스템 종속 경로 구분 기호에 의해 구분되는 요구되는 자원에 전체 경로를 추가하십시오.

    [AIX Solaris HP-UX Linux Windows][z/OS]예: JspBatchCompiler -war.path c:\myproject\examples.war -additional.classpath c:\myJars\someJar.jar;c:\myClasses

    [IBM i]예: JspBatchCompiler -war.path /home/wasuser/myproject/examples.war -additional.classpath /home/wasuser/myJars/someJar.jar:/home/wasuser/myClasses

    유스 케이스: 이 매개변수를 사용하여 WAR 파일의 외부에서 클래스 경로 JAR 파일 및 클래스에 추가하십시오. 런타임 시, 표준 WebSphere Application Server 구성 메커니즘을 통해 이러한 동일한 JAR 파일 및 클래스가 사용 가능한 상태가 되어야 합니다.

    기본: null

  • verbose

    일괄처리 컴파일러가 생성된 소스를 컴파일하는 동안 자세한 출력을 생성해야 합니다.

    [AIX Solaris HP-UX Linux Windows][z/OS]예: JspBatchCompiler -war.path c:\myproject\examples.war -verbose true

    [IBM i]예: JspBatchCompiler -war.path /home/wasuser/myproject/examples.war -verbose true

    유스 케이스: Java 컴파일러 클래스 로딩 및 기타 메시지를 보려고 할 때 이 매개변수를 true로 설정하십시오.

    기본값: false

  • deprecation

    컴파일러는 생성된 소스를 컴파일하는 동안 사용 불가 경고를 생성해야 한다는 것을 표시합니다.

    [AIX Solaris HP-UX Linux Windows][z/OS]예: JspBatchCompiler -war.path c:\myproject\examples.war -deprecation true

    [IBM i]예: JspBatchCompiler -war.path /home/wasuser/myproject/examples.war -deprecation true

    유스 케이스: Java 컴파일러 사용 불가 경고 메시지를 보려고 할 때 이 매개변수를 true로 설정하십시오.

    기본값: false

  • javaEncoding

    .java 파일이 생성되고 Java 컴파일러에 의해 컴파일될 때의 인코딩을 지정합니다. -javaEncoding이 설정되면, 인코딩은 -encoding 인수를 사용하여 Java 컴파일러에 전달됩니다. 인코딩은 Jikes에 의해 지원되지 않는다는 것을 참고하십시오.

    [AIX Solaris HP-UX Linux Windows][z/OS]예: JspBatchCompiler -war.path c:\myproject\examples.war -javaEncoding Shift-JIS

    [IBM i]예: JspBatchCompiler -war.path/home/wasuser/myproject/examples.war -javaEncoding Shift-JIS

    유스 케이스: JSP 페이지의 페이지 인코딩이 UTF-8 호환 가능이 아닐 때 이 매개변수를 설정하십시오.

    기본값: UTF-8.

  • jdkSourceLevel

    이 JSP 엔진 매개변수는 JDK 5를 지원하기 위해 WebSphere Application Server 버전 6.1에서 소개됩니다. 컴파일 WithAssert가 버전 6.1에서 작동할지라도 compileWithAssert 매개변수 대신 이 매개변수를 사용하십시오.

    이 매개변수에 대한 기본값은 17입니다. 이 매개변수에는 Java 소스의 재생이 필요합니다. 다음은 jdkSourceLevel 매개변수 값입니다.
    • 13은 JDK 1.4, JDK 5.0, JDK 6.0, JDK 7.0 및 8.0의 모든 새 언어 기능을 사용 불가능으로 설정합니다.
    • 14는 어설션 기능의 사용을 사용 가능하게 하고 JDK 5.0, JDK 6.0, JDK 7.0 및 8.0의 모든 새 언어 기능을 사용 불가능으로 설정합니다.
    • 15는 어설션 기능의 사용을 사용 가능하게 하고 JDK 6.0, JDK 7.0 및 8.0의 모든 새 언어 기능을 사용 불가능으로 설정합니다.
    • 16은 어설션 기능의 사용을 사용 가능하게 하고 JDK 7.0 및 8.0의 모든 새 언어 기능을 사용 불가능으로 설정합니다.
    • 17은 어설션 기능의 사용을 사용 가능하게 하고 JDK 8.0의 모든 새 언어 기능을 사용 불가능으로 설정합니다.
    • 18은 JDK 8.0의 새 기능의 사용을 사용 가능하게 합니다.

    예: JspBatchCompiler -war.path c:\myproject\examples.war -jdkSourceLevel 14

    유스 케이스: JDK 1.4 , JDK 5.0, JDK 6.0, JDK 7.0 및 8.0의 언어 기능을 사용 가능 또는 사용 불가능으로 설정하려고 할 때 이 매개변수를 설정하십시오.

    기본값: 17

  • compilerOptions

    Java 컴파일러 명령에서 전달되는 문자열의 목록을 지정합니다. 이는 양식 "arg1 arg2 argn"의 공백 구분 목록입니다.

    [AIX Solaris HP-UX Linux Windows][z/OS]예: JspBatchCompiler -war.path c:\myproject\examples.war -compilerOptions "-bootclasspath <path>"

    [IBM i]예: JspBatchCompiler -war.path /home/wasuser/myproject/examples.war -compilerOptions "-bootclasspath <path>"

    유스 케이스: 상세, 사용 불가 경고 및 Assert 기능 지원 이외의 Java 컴파일러 인수가 필요한 경우 이 매개변수를 사용하십시오.

    기본: null

  • useJikes

    Jikes가 Java 소스를 컴파일하기 위해 사용되어야 하는지 여부를 지정합니다. 참고: Jikes는 WebSphere Application Server와 함께 제공되지 않습니다.

    [AIX Solaris HP-UX Linux Windows][z/OS]예: JspBatchCompiler -ear.path c:\myproject\sampleApp.ear -useJikes true

    [IBM i]예: JspBatchCompiler -ear.path /home/wasuser/myproject/sampleApp.ear -useJikes true

    유스 케이스: 일괄처리 컴파일러가 Java 컴파일러로서 Jikes를 사용하기 위해 이 매개변수를 true로 설정하십시오.

    기본값: false

  • jsp.file.extensions

    일괄처리 컴파일러에 의해 처리될 파일 확장자를 지정합니다. 이는 양식 *.ext1;*.ext2:*.extn의 세미콜론 또는 콜론으로 구분된 목록입니다. 배치 디스크립터에서 JSP 특성 그룹 요소의 URL 패턴 특성이 JSP 페이지로서 처리되어야 하는 확장자를 식별하기 위해 사용될 수 있으므로 이 매개변수는 서블릿 2.4 웹 애플리케이션에 필요하지 않다는 것에 주의하십시오.

    예: JspBatchCompiler -enterpriseApp.name sampleApp -jsp.file.extensions *jspz;*.jspt

    유스 케이스: 이 매개변수를 사용하여 일괄처리 컴파일러에 의해 처리되는 추가 확장자를 추가하십시오.

    기본: null. 추가 정보는 이 주제에서 "JSP 파일 확장자" 섹션을 참조하십시오.

  • log.level

    일괄처리 컴파일 동안 콘솔로 보내지는 로깅 레벨을 지정합니다. 값은 SEVERE | WARNING | INFO | CONFIG | FINE | FINER | FINEST | OFF

    입니다.

    예: JspBatchCompiler -enterpriseApp.name sampleApp -log.level FINEST

    유스 케이스: 로깅 출력을 제어하기 위해 이 매개변수를 이상 또는 격하로 설정하십시오. FINEST는 디버깅을 위해 유용한 대부분의 출력을 생성합니다.

    기본: CONFIG


주제 유형을 표시하는 아이콘 참조 주제



시간소인 아이콘 마지막 업데이트 날짜: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rweb_jspbchtl
파일 이름:rweb_jspbchtl.html