포틀릿 URL(Uniform Resource Locator) 주소지정 가능성

URL(Uniform Resource Locator)을 통해 직접 포틀릿에 요청하여 포털 집계 없이 해당 컨텐츠를 표시할 수 있습니다. PortletServingServlet 서블릿은 포틀릿이 포함된 각 웹 애플리케이션을 등록합니다. 이 서블릿은 자원을 제공하는 웹 컨테이너의 FileServingServlet 서블릿과 유사합니다. PortletServingServlet 서블릿은 URL 요청으로 전체 브라우저 페이지에 직접 포틀릿 렌더링을 지원합니다.

해당 컨텍스트 루트 및 각 포틀릿에 대해 작성된 URL 맵핑 /<portlet-name>이 포함된 이름으로 각 포틀릿을 호출할 수 있습니다. 예를 들어, 다음과 같습니다.
http://<host>:<port>/<context-root>/<portlet-name> For example, 
 http://localhost:9080/portlets/TestPortlet1
컨텍스트 루트는 포틀릿이 포함된 WAR(Web Application Archive) 파일을 식별합니다. 포틀릿 이름은 WAR 파일의 포틀릿을 적용하여 포틀릿을 고유하게 식별합니다. DefaultDocumentFilter 서블릿은 HTML, UTF8 인코딩, 기본 URL 양식을 기반으로 하는 확장 URL 양식만 지원합니다.

PortletServingServlet 서블릿을 사용하여 한 번에 하나의 포틀릿만 표시할 수 있습니다. 페이지에서 여러 포틀릿을 집계하려면 집계 태그 라이브러리를 사용해야 합니다. 추가 정보는 JavaServer Pages를 사용한 포틀릿 집계 문서를 참조하십시오.

서블릿은 보통 문서 출력을 전달하는 반면 포틀릿은 단편 출력만 전달하므로, 단편을 문서로 변환하기 위해 PortletDocumentFilter 필터라고 하는 메커니즘이 도입되었습니다. 기본적으로, PortletDocumentFilter 필터는 HTML 변환만 지원합니다. 변환은 PortletServingServlet 서블릿이 시작되어 문서 내의 포틀릿 컨텐츠를 리턴하기 전에 서블릿 필터를 사용하여 구현됩니다. 이 기본 문서 서블릿 필터는 RequestDispatcher 메소드를 사용하여 포함되거나 전달되지 않고 단지 URL 요청에 적용됩니다. 서블릿 필터를 작성하여 다른 마크업 추가 문서 서블릿 필터를 지원할 수 있습니다. 추가 정보는 포틀릿 단편을 HTML 문서로 변환 기사를 참조하십시오.

PortletServingServlet 서블릿은 XML 파일이나 데이터베이스에서 포틀릿 환경 설정을 지속하지 않습니다. 이 서블릿은 포틀릿 환경 설정을 직접 쿠키에 배치하여 환경 설정을 지속적으로 저장합니다. 이 동작 변경 방법에 대한 추가 정보는 포틀릿 환경 설정 문서를 참조하십시오.

포틀릿 URL 구문

포틀릿 모드나 창 상태와 같은 포털 컨텍스트를 더 추가할 수 있습니다. 다음 구조의 URL 맵핑을 사용하여 PortletServingServlet 서블릿에 액세스할 수 있습니다.
http://host:port/context/portlet-name [/portletwindow[/ver [/action | 
 /resource[/id=custom-id][/cacheability]] [/mode] [/state] [rparam][/?name]]]
다른 URL 구조를 사용하면 com.ibm.wsspi.portletcontainer.InvalidURLException 예외가 발생합니다. 빈 문자열은 매개변수 값으로 허용되지 않으며 InvalidURLException 예외가 발생합니다. 다음은 유효한 매개변수 목록입니다.
http:// host:port/context/portlet-name
이는 포틀릿에 액세스하는 데 필요한 최소 URL입니다. "기본값"이라는 기본 포틀릿 창이 작성됩니다. portlet-name 변수는 대소문자를 구분합니다.
/portletwindow
이 매개변수는 포틀릿 창을 식별합니다. URL에 포털 컨텍스트 정보를 더 추가할 것을 선택하면 이 매개변수를 설정해야 합니다.
/ver=major.minor
이 선택적 매개변수는 사용되는 포틀릿 API 버전 정의에 사용됩니다. URL에 포털 컨텍스트 정보를 더 추가할 것을 선택하면 이 매개변수를 설정해야 합니다. "1.0""2.0" 버전만 지원됩니다. 다른 버전을 사용하면 InvalidURLException 예외가 발생합니다.
/action
이는 포틀릿의 action 메소드를 호출하는 경우 필요한 매개변수입니다. action 매개변수는 포틀릿의 조치 프로세스가 호출되도록 합니다. 조치가 완료되고 나면 경로 재지정이 자동으로 발행되어 렌더링 프로세스를 호출합니다. 후속 렌더링 프로세스를 제어하기 위해 문서 서블릿 필터는 렌더링 프로세스를 호출하지 않고 조치 후에 PortletServingServlet이 직접 리턴되도록 지정하기 위해 이름 "com.ibm.websphere.portlet.action" 및 값 "redirect"로 요청 속성을 설정할 수 있습니다.
/mode=view | edit | help | custom-mode
이 선택적 매개변수는 포틀릿을 렌더링하는 데 사용되는 포틀릿 모드를 정의합니다. 기본 모드는 "view"입니다. 값은 대소문자를 구분하지 않습니다. 예를 들어, "Vew", "view" 또는 "VIEW" 모두 동일한 모드가 됩니다.
/state=normal | maximized | minimized | custom-state
이 선택적 매개변수는 포틀릿을 렌더링하는 데 사용되는 창 상태를 정의합니다. 기본 상태는 "normal"입니다. 값은 대소문자를 구분하지 않으며 "Normal", "normal" 또는 "NORMAL" 모두 동일한 상태가 됩니다.
* [ /rparam=name *[=value] ]
이 선택적 매개변수는 포틀릿의 렌더링 매개변수를 지정합니다. 이 매개변수 체인을 반복하여 둘 이상의 렌더링 매개변수를 제공하십시오. 예: /rparam=invitation/rparam=days=Monday=Tuesday.
?name=value&name2=value2 …
조회 매개변수가 선택적으로 뒤에 올 수 있습니다. 포틀릿 컨테이너에서 명시적으로 지원되지는 않지만 URL 형식을 무효화하지는 않습니다.
/action | /resource
이 매개변수는 호출되는 포틀릿의 메소드를 정의합니다. 유효값은 no, action 또는 resource 매개변수입니다. 정의된 특정 메소드가 렌더링 메소드를 호출하지 않습니다. 매개변수는 JSR 286 포틀릿에 대해서만 지원됩니다.
/resource [/id=custom-id] [/cacheability=cacheLevelFull | cacheLevelPortlet | cacheLevelPage]
호출할 포틀릿 메소드를 정의하려면 이 매개변수를 설정하십시오. 경로 재지정이 발생하지 않습니다. 포틀릿의 다른 메소드는 호출되지 않습니다. resource 매개변수를 제어하기 위해 추가 ID 매개변수를 추가하여 포틀릿으로 전달되는 자원 제공 ID를 제공할 수 있습니다. cacheability 매개변수는 이 자원 URL의 캐시 레벨을 정의합니다. 이 매개변수는 JSR 286 포틀릿에서만 지원됩니다.
[AIX Solaris HP-UX Linux Windows][z/OS]다음 목록은 유효한 JSR 168 및 JSR 286 URL의 예제를 포함합니다.
  • http:// localhost:9080/sample/WorldClock
  • http:// localhost:9080/sample/WorldClock/myPortlet/ver=1.0/mode=edit/rparam=timezone=UTC
  • http:// localhost:9080/sample/WorldClock/myPortlet/ver=1.0/action/state=maximized?timezone=UTC
  • http://localhost:9080/sample/WorldClock/myPortlet/ver=2.0/resource/id=somePicture.jpg
[IBM i]다음 목록은 유효한 JSR 168 및 JSR 286 URL의 예제를 포함합니다.
  • http:// your.server.name:9080/sample/WorldClock
  • http:// your.server.name:9080/sample/WorldClock/myPortlet/ver=1.0/mode=edit/rparam=timezone=UTC
  • http:// your.server.name:9080/sample/WorldClock/myPortlet/ver=1.0/action/state=maximized?timezone=UTC
  • http://your.server.name:9080/sample/WorldClock/myPortlet/ver=2.0/resource/id=somePicture.jpg

주제 유형을 표시하는 아이콘 개념 주제



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