com.ecyrd.jspwiki.attachment

Class AttachmentServlet

java.lang.Object

HttpServlet

com.ecyrd.jspwiki.dav.WebdavServlet

com.ecyrd.jspwiki.attachment.AttachmentServlet

public class AttachmentServlet
extends WebdavServlet

This is the chief JSPWiki attachment management servlet. It is used for both uploading new content and downloading old content. It can handle most common cases, e.g. check for modifications and return 304's as necessary.

Authentication is done using JSPWiki's normal AAA framework.

This servlet is also capable of managing dynamically created attachments.

Since:

1.9.45.

Author:

Erik Bunn

Field Summary

Fields

Modifier and Type	Field and Description
protected static long	DEFAULT_EXPIRY Default expiry period is 1 day

Fields inherited from class com.ecyrd.jspwiki.dav.WebdavServlet

SC_FAILED_DEPENDENCY, SC_INSUFFICIENT_STORAGE, SC_LOCKED, SC_MULTISTATUS, SC_PROCESSING, SC_UNPROCESSABLE

Constructor Summary

Constructors

Constructor and Description
AttachmentServlet()

Method Summary

Modifier and Type	Method and Description
void	doGet(HttpServletRequest req, HttpServletResponse res) Serves a GET with two parameters: 'wikiname' specifying the wikiname of the attachment, 'version' specifying the version indicator.
protected void	doOptions(HttpServletRequest req, HttpServletResponse res) Implements the OPTIONS method.
void	doPost(HttpServletRequest req, HttpServletResponse res) Grabs mime/multipart data and stores it into the temporary area.
void	doPropFind(HttpServletRequest req, HttpServletResponse res) Implements the PROPFIND method.
void	doPut(HttpServletRequest req, HttpServletResponse res)
protected boolean	executeUpload(WikiContext context, java.io.InputStream data, java.lang.String filename, java.lang.String errorPage, java.lang.String parentPage, java.lang.String changenote, long contentLength)
void	init(ServletConfig config) Initializes the servlet from WikiEngine properties.
protected java.lang.String	upload(HttpServletRequest req) Uploads a specific mime multipart input set, intercepts exceptions.

Methods inherited from class com.ecyrd.jspwiki.dav.WebdavServlet

doCopy, doLock, doMkCol, doMove, doPropPatch, doUnlock, service

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_EXPIRY

protected static final long DEFAULT_EXPIRY

Default expiry period is 1 day

See Also:

Constant Field Values

Constructor Detail

AttachmentServlet

public AttachmentServlet()

Method Detail

init

public void init(ServletConfig config)
          throws ServletException

Initializes the servlet from WikiEngine properties.

Throws:

ServletException

doPropFind

public void doPropFind(HttpServletRequest req,
                       HttpServletResponse res)
                throws java.io.IOException,
                       ServletException

Implements the PROPFIND method.

Overrides:

doPropFind in class WebdavServlet

Parameters:

req - The servlet request

res - The servlet response

Throws:

java.io.IOException - If input/output fails

ServletException - If the servlet has issues

doOptions

protected void doOptions(HttpServletRequest req,
                         HttpServletResponse res)

Implements the OPTIONS method.

Parameters:

req - The servlet request

res - The servlet response

doGet

public void doGet(HttpServletRequest req,
                  HttpServletResponse res)
           throws java.io.IOException,
                  ServletException

Serves a GET with two parameters: 'wikiname' specifying the wikiname of the attachment, 'version' specifying the version indicator.

Throws:

java.io.IOException

ServletException

doPost

public void doPost(HttpServletRequest req,
                   HttpServletResponse res)
            throws java.io.IOException,
                   ServletException

Grabs mime/multipart data and stores it into the temporary area. Uses other parameters to determine which name to store as.

The input to this servlet is generated by an HTML FORM with two parts. The first, named 'page', is the WikiName identifier for the parent file. The second, named 'content', is the binary content of the file.

Throws:

java.io.IOException

ServletException

doPut

public void doPut(HttpServletRequest req,
                  HttpServletResponse res)
           throws java.io.IOException,
                  ServletException

Throws:

java.io.IOException

ServletException

upload

protected java.lang.String upload(HttpServletRequest req)
                           throws RedirectException,
                                  java.io.IOException

Uploads a specific mime multipart input set, intercepts exceptions.

Parameters:

req - The servlet request

Returns:

The page to which we should go next.

Throws:

RedirectException - If there's an error and a redirection is needed

java.io.IOException - If upload fails

FileUploadException

executeUpload

protected boolean executeUpload(WikiContext context,
                                java.io.InputStream data,
                                java.lang.String filename,
                                java.lang.String errorPage,
                                java.lang.String parentPage,
                                java.lang.String changenote,
                                long contentLength)
                         throws RedirectException,
                                java.io.IOException,
                                ProviderException

Parameters:

context - the wiki context

data - the input stream data

filename - the name of the file to upload

errorPage - the place to which you want to get a redirection

parentPage - the page to which the file should be attached

changenote - The change note

contentLength - The content length

Returns:

true if upload results in the creation of a new page; false otherwise

Throws:

RedirectException - If the content needs to be redirected

java.io.IOException - If there is a problem in the upload.

ProviderException - If there is a problem in the backend.