Package org.zkoss.zk.au.http
Interface AuExtension
-
- All Known Implementing Classes:
AuDownloader
,AuDynaMediar
,AuRedirect
public interface AuExtension
An AU service is a small Java program that can be plugged intoDHtmlUpdateServlet
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
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description default java.lang.Object
charsetSetup(Session session, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
Sets the charset of the response.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 toDHtmlUpdateServlet
.- Throws:
javax.servlet.ServletException
-
destroy
void destroy()
Destroys the AU extension. It is called when an extension is removed fromDHtmlUpdateServlet
, or whenDHtmlUpdateServlet
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 (seeDHtmlUpdateServlet.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
-
charsetSetup
default java.lang.Object charsetSetup(Session session, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
Sets the charset of the response.- Parameters:
session
- ZK session (might be null).request
- the request (never null).response
- the response (never null).- Returns:
- an object that must be passed to
I18Ns.cleanup(javax.servlet.ServletRequest, java.lang.Object)
orCharsets.cleanup(javax.servlet.ServletRequest, java.lang.Object)
(can be null). - Since:
- 9.5.1
-
-