org.zkoss.zk.au.http
Interface AuExtension

All Known Implementing Classes:

AuDownloader, AuDynaMediar, AuUploader

public interface AuExtension

An AU service is a small Java program that can be plugged into DHtmlUpdateServlet to extend its functionality. An AU processor is associated with a prefix when plugged into the update servlet. Then, when a request with the prefix is received, the corresponding AU process is invoked to handle the request).

Since:

5.0.0

Author:

tomyeh

Method Summary

void	destroy() Destroyes the AU extension.
void	init(DHtmlUpdateServlet servlet) Initializes the AU extension.
void	service(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, java.lang.String pi) Called by ZK to process the AU request.

Method Detail

init

void init(DHtmlUpdateServlet servlet)
          throws javax.servlet.ServletException

Initializes the AU extension. It is called when an extension is added to DHtmlUpdateServlet.

Throws:

javax.servlet.ServletException

destroy

void destroy()

Destroyes the AU extension. It is called when an extension is removed from DHtmlUpdateServlet, or when DHtmlUpdateServlet is being destroyed.

service

void service(javax.servlet.http.HttpServletRequest request,
             javax.servlet.http.HttpServletResponse response,
             java.lang.String pi)
             throws javax.servlet.ServletException,
                    java.io.IOException

Called by ZK to process the AU request.

To retrieve the http session, use HttpServletRequest.getSession(). To retrieve the ZK session, use Sessions.getCurrent(boolean).

Parameters:

request - the request (never null).

response - the response (never null).

pi - the path info. It includes the prefix when the Au processor is associated (see DHtmlUpdateServlet.addAuExtension(org.zkoss.zk.ui.WebApp, java.lang.String, org.zkoss.zk.au.http.AuExtension). For example, if an AU processor is assoicated with "/upload", then pi must start with "/upload". Note: it might end with other string depending on the URI you generated to the client.

Throws:

javax.servlet.ServletException

java.io.IOException