*	 * @param skipInclude whether not to convert to an absolute URI if	 * the current page is included by another page.	 * When use the include directive, skipInclude shall be true.	 */	public String toAbsoluteURI(String uri, boolean skipInclude);	/** Encodes an URL.	 *	 * <p>It resolves "*" contained in URI, if any, to the proper Locale,	 * and the browser code.	 * Refer to {@link Servlets#locate(ServletContext, ServletRequest, String, Locator)}	 * for details. 	 */	public String encodeURL(String uri);	/** Returns a java.security.Principal object containing the name of the	 * current authenticated user.	 * If the user has not been authenticated, the method returns null.	 */	public Principal getUserPrincipal();	/** Returns a boolean indicating whether the authenticated user is	 * included in the specified logical "role". Roles and role membership	 * can be defined using deployment descriptors.	 * If the user has not been authenticated, the method returns false.	 *	 * @param role a String specifying the name of the role	 */	public boolean isUserInRole(String role);	/** Returns the login of the user making this request, if the user has	 * been authenticated, or null if the user has not been authenticated.	 * Whether the user name is sent with each subsequent request depends on	 * the browser and type of authentication.	 */	public String getRemoteUser();	/** Returns the fully qualified name of the client or the last proxy	 * that sent the request.	 * If the engine cannot or chooses not to resolve the hostname	 * (to improve performance), this method returns the dotted-string form of	 * the IP address.	 */	public String getRemoteName();	/**  Returns the Internet Protocol (IP) address of the client or last	 * proxy that sent the request.	 */	public String getRemoteAddr();	/** Returns the host name of the server to which the request was sent.	 * It is the value of the part before ":" in the Host header value, if any,	 * or the resolved server name, or the server IP address.	 *	 * @see #getLocalName	 */	public String getServerName();	/** Returns the port number to which the request was sent.	 * It is the value of the part after ":" in the Host header value, if any,	 * or the server port where the client connection was accepted on.	 *	 * @see #getLocalPort	 */	public int getServerPort();	/** Returns the host name of the Internet Protocol (IP) interface	 * on which the request was received.	 *	 * <p>Note: it is the host name defined in the server. To retrieve the name	 * in URL, use {@link #getServerName}.	 *	 * @see #getServerName	 */	public String getLocalName();	/** Returns the Internet Protocol (IP) address of the interface on which	 * the request was received.	 */	public String getLocalAddr();	/** Returns the Internet Protocol (IP) port number of the interface on which	 * the request was received.	 *	 * @see #getServerPort	 */	public int getLocalPort();	/** Returns the portion of the request URI that indicates the context of	 * the current execution. The path starts with a "/" character but does not end with	 * a "/" character. For servlets in the default (root) context,	 * this method returns "".	 *	 * <p>If the client is not using HTTP to access, this method return "";	 *	 * @see Page#getRequestPath	 */	public String getContextPath();	//-- page utilities --//	/** Returns the page definition from the page file specified by an URI.	 *	 * <p>Implemetation Notes: this method must invoke	 * {@link org.zkoss.zk.ui.sys.UiFactory#getPageDefinition(org.zkoss.zk.ui.sys.RequestInfo, String)}	 *	 * @param uri the URI of the page file.	 *	 * @see #getPageDefinitionDirectly(String, String)	 * @see #getPageDefinitionDirectly(Document, String)	 * @see #getPageDefinitionDirectly(Reader, String)	 */	public PageDefinition getPageDefinition(String uri);	/** Converts the specified page content to a page definition.	 *	 * <p>Implemetation Notes: this method must invoke	 * {@link org.zkoss.zk.ui.sys.UiFactory#getPageDefinitionDirectly(org.zkoss.zk.ui.sys.RequestInfo, String, String)}	 *	 * @param content the raw content of the page. It must be in ZUML.	 * @param extension the default extension if the content doesn't specify	 * an language. In other words, if	 * the content doesn't specify an language, {@link LanguageDefinition#getByExtension}	 * is called.	 * If extension is null and the content doesn't specify a language,	 * the language called "xul/html" is assumed.	 * @see #getPageDefinitionDirectly(Document, String)	 * @see #getPageDefinitionDirectly(Reader, String)	 * @see #getPageDefinition	 */	public PageDefinition getPageDefinitionDirectly(String content, String extension);	/** Converts the specified page content, in DOM, to a page definition.	 *	 * @param content the raw content of the page in DOM.	 * @param extension the default extension if the content doesn't specify	 * an language. In other words, if	 * the content doesn't specify an language, {@link LanguageDefinition#getByExtension}	 * is called.	 * If extension is null and the content doesn't specify a language,	 * the language called "xul/html" is assumed.	 * @see #getPageDefinitionDirectly(String, String)	 * @see #getPageDefinitionDirectly(Reader, String)	 * @see #getPageDefinition	 */	public PageDefinition getPageDefinitionDirectly(Document content, String extension);	/** Reads the raw content from a reader and converts it into	 * a page definition.	 *	 * @param reader used to input the raw content of the page. It must be in ZUML.	 * @param extension the default extension if the content doesn't specify	 * an language. In other words, if	 * the content doesn't specify an language, {@link LanguageDefinition#getByExtension}	 * is called.	 * If extension is null and the content doesn't specify a language,	 * the language called "xul/html" is assumed.	 * @see #getPageDefinitionDirectly(String, String)	 * @see #getPageDefinitionDirectly(Document, String)	 * @see #getPageDefinition	 */	public PageDefinition getPageDefinitionDirectly(Reader reader, String extension)	throws IOException;	/** Creates components from the specified page definition.	 * The created components become the child of the specified parent,	 * or become the root components of the current page if parent is specified	 * as null.	 *	 * @param pagedef the page definition to use. It cannot be null.	 * @param parent the parent component, or null if you want it to be	 * a root component. If parent is null, the page is assumed to be	 * the current page, which is determined by the execution context.	 * @param arg a map of parameters that is accessible by the arg variable	 * in EL, or by {@link Execution#getArg}.	 * Ignored if null.	 * @return the first component being created.	 * @see #createComponents(String, Component, Map)	 */	public Component createComponents(PageDefinition pagedef,	Component parent, Map arg);	/** Creates components from a page file specified by an URI.	 * The created components become the child of the specified parent,	 * or become the root components of the current page if parent is specified	 * as null.	 *	 * <p>It loads the page definition from the specified URI (by	 * use {@link #getPageDefinition} ), and then	 * invokes {@link #createComponents(PageDefinition,Component,Map)}	 * to create components.	 *	 * @param parent the parent component, or null if you want it to be	 * a root component. If parent is null, the page is assumed to be	 * the current page, which is determined by the execution context.	 * @param arg a map of parameters that is accessible by the arg variable	 * in EL, or by {@link Execution#getArg}.	 * Ignored if null.	 * @see #createComponents(PageDefinition, Component, Map)	 * @see #createComponentsDirectly(String, String, Component, Map)	 * @see #createComponentsDirectly(Document, String, Component, Map)	 * @see #createComponentsDirectly(Reader, String, Component, Map)	 */	public Component createComponents(String uri, Component parent,	Map arg);	/** Creates components from the raw content specified by a string.	 * The created components become the child of the specified parent,	 * or become the root components of the current page if parent is specified	 * as null.	 *	 * <p>The raw content is parsed to a page defintion by use of	 * {@link #getPageDefinitionDirectly(String, String)}, and then	 * invokes {@link #createComponents(PageDefinition,Component,Map)}	 * to create components.	 *	 * @param content the raw content of the page. It must be in ZUML.	 * @param extension the default extension if the content doesn't specify	 * an language. In other words, if	 * the content doesn't specify an language, {@link LanguageDefinition#getByExtension}	 * is called.	 * If extension is null and the content doesn't specify a language,	 * the language called "xul/html" is assumed.	 * @param parent the parent component, or null if you want it to be	 * a root component. If parent is null, the page is assumed to be	 * the current page, which is determined by the execution context.	 * @param arg a map of parameters that is accessible by the arg variable	 * in EL, or by {@link Execution#getArg}.	 * Ignored if null.	 * @see #createComponents(PageDefinition, Component, Map)	 * @see #createComponents(String, Component, Map)	 * @see #createComponentsDirectly(Document, String, Component, Map)	 * @see #createComponentsDirectly(Reader, String, Component, Map)	 */	public Component createComponentsDirectly(String content, String extension,	Component parent, Map arg);	/** Creates components from the raw content specified by a DOM tree.	 * The created components become the child of the specified parent,	 * or become the root components of the current page if parent is specified	 * as null.	 *	 * <p>The raw content is parsed to a page defintion by use of	 * {@link #getPageDefinitionDirectly(Document, String)}, and then	 * invokes {@link #createComponents(PageDefinition,Component,Map)}	 * to create components.	 *	 * @param content the raw content in DOM.	 * @param extension the default extension if the content doesn't specify	 * an language. In other words, if	 * the content doesn't specify an language, {@link LanguageDefinition#getByExtension}	 * is called.	 * If extension is null and the content doesn't specify a language,	 * the language called "xul/html" is assumed.	 * @param parent the parent component, or null if you want it to be	 * a root component. If parent is null, the page is assumed to be	 * the current page, which is determined by the execution context.	 * @param arg a map of parameters that is accessible by the arg variable	 * in EL, or by {@link Execution#getArg}.	 * Ignored if null.	 * @see #createComponents(PageDefinition, Component, Map)	 * @see #createComponents(String, Component, Map)	 * @see #createComponentsDirectly(Document, String, Component, Map)	 * @see #createComponentsDirectly(Reader, String, Component, Map)	 */	public Component createComponentsDirectly(Document content, String extension,	Component parent, Map arg);	/** Creates components from the raw content read from the specified reader.	 * The created components become the child of the specified parent,	 * or become the root components of the current page if parent is specified	 * as null.	 *	 * <p>The raw content is loaded and parsed to a page defintion by use of	 * {@link #getPageDefinitionDirectly(Reader,String)}, and then	 * invokes {@link #createComponents(PageDefinition,Component,Map)}	 * to create components.	 *