org.zkoss.zk.au.http
Interface AuExtension

All Known Implementing Classes:
AuDownloader, AuDropUploader, 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()
          Destroys 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()
Destroys 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 associated 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


Copyright © 2005-2011 Potix Corporation. All Rights Reserved. SourceForge.net Logo