com.xpn.xwiki.api
Class Document

java.lang.Object
  extended by com.xpn.xwiki.api.Api
      extended by com.xpn.xwiki.api.Document

public class Document
extends Api

This class represents a document or page in the wiki. This is a security and usability wrapper which wraps XWikiDocument In scripting, an object representing the document in which the script resides will be bound to a variable called doc.

Version:
$Id: 738bdd6e784f9350b87a0f23035940c2618cdc1c $

Field Summary
protected  boolean cloned
          Indicates if this API wraps a cloned XWikiDocument.
protected  Object currentObj
          Convenience object used by object related methods.
protected  com.xpn.xwiki.doc.XWikiDocument doc
          The XWikiDocument object wrapped by this API.
 
Fields inherited from class com.xpn.xwiki.api.Api
context
 
Constructor Summary
Document(com.xpn.xwiki.doc.XWikiDocument doc, com.xpn.xwiki.XWikiContext context)
          Document constructor.
 
Method Summary
 Attachment addAttachment(String fileName, byte[] data)
           
 Attachment addAttachment(String fileName, InputStream iStream)
           
 int addAttachments()
           
 int addAttachments(String fieldName)
           
 Object addObjectFromRequest()
           
 Object addObjectFromRequest(String className)
           
 Object addObjectFromRequest(String className, String prefix)
           
 List<Object> addObjectsFromRequest(String className)
           
 List<Object> addObjectsFromRequest(String className, String prefix)
           
 boolean checkAccess(String right)
           
 boolean convertSyntax(String targetSyntaxId)
          Convert the current document content from its current syntax to the new syntax passed as parameter.
 int createNewObject(String classname)
           
 void delete()
           
 void deleteAsAuthor()
          Delete the document if the content author of the script calling this method has permission to do so.
protected  void deleteDocument()
          Remove document from the wiki.
 void deleteWithProgrammingRights()
           
 String display(String fieldname)
           
 String display(String fieldname, Object obj)
           
 String display(String fieldname, String mode)
           
 String display(String fieldname, String mode, Object obj)
           
 String display(String fieldname, String type, Object obj, String wrappingSyntaxId)
           
 String display(String fieldname, String mode, String prefix)
           
 String display(String fieldname, String mode, String prefix, Object obj)
           
 String displayEdit(PropertyClass pclass, String prefix, Collection object)
           
 String displayForm(String className)
           
 String displayForm(String className, String header, String format)
           
 String displayForm(String className, String header, String format, boolean linebreak)
           
 String displayHidden(PropertyClass pclass, String prefix, Collection object)
           
 String displayPrettyName(String fieldname)
           
 String displayPrettyName(String fieldname, boolean showMandatory)
           
 String displayPrettyName(String fieldname, boolean showMandatory, boolean before)
           
 String displayPrettyName(String fieldname, boolean showMandatory, boolean before, Object obj)
           
 String displayPrettyName(String fieldname, boolean showMandatory, Object obj)
           
 String displayPrettyName(String fieldname, Object obj)
           
 String displayRendered(PropertyClass pclass, String prefix, Collection object)
           
 String displayTooltip(String fieldname)
           
 String displayTooltip(String fieldname, Object obj)
           
 String displayView(PropertyClass pclass, String prefix, Collection object)
           
 void dropPermissions()
          Drop permissions for the remainder of the rendering cycle.
 boolean equals(Object arg0)
           
 Object get(String classOrFieldName)
           
 String getActiveClass()
           
 String getArchive()
           
 Attachment getAttachment(String filename)
           
 List<com.xpn.xwiki.doc.AttachmentDiff> getAttachmentDiff(Document origdoc, Document newdoc)
           
 List<Attachment> getAttachmentList()
           
 String getAttachmentRevisionURL(String filename, String version)
          Get an old revision of an attachment.
 String getAttachmentRevisionURL(String filename, String version, String queryString)
          Get an old revision of an attachment.
 String getAttachmentURL(String filename)
          Return the URL of download for the the given attachment name.
 String getAttachmentURL(String filename, String action)
          Get the URL of the given action for the the given attachment name.
 String getAttachmentURL(String filename, String action, String queryString)
          Get the URL of an action on an attachment.
 String getAuthor()
          Get fullName of the profile document of the author of the current version of the document.
 List<String> getBacklinks()
           
 List<String> getChildren()
          Get document children.
 List<String> getChildren(int nb, int start)
          Get document children.
 List<List<com.xpn.xwiki.objects.ObjectDiff>> getClassDiff(Document origdoc, Document newdoc)
           
 String getComment()
           
 Vector<Object> getComments()
           
 Vector<Object> getComments(boolean asc)
           
 String getContent()
          Get raw content of the document, i.e.
 String getContentAuthor()
          Get fullName of the profile document of the author of the last content modification in the document.
 List<org.suigeneris.jrcs.diff.delta.Delta> getContentDiff(Document origdoc, Document newdoc)
           
 Date getContentUpdateDate()
          Get the date when the last content modification has been done on the document.
 Date getCreationDate()
          Get the date when the document has been created.
 String getCreator()
          Get fullName of the profile document of the document creator.
 com.xpn.xwiki.stats.impl.DocumentStats getCurrentMonthPageStats(String action)
          Get statistics about the number of request for the current page during the current month.
 List<com.xpn.xwiki.stats.impl.RefererStats> getCurrentMonthRefStats()
          Get referer statistics for the current document during the current month.
 com.xpn.xwiki.stats.impl.DocumentStats getCurrentMonthSpaceStats(String action)
          Get statistics about the number of request for the current space during the current month.
 Date getDate()
          Get the date when the current document version has been created, i.e.
 String getDefaultEditMode()
           
 String getDefaultEditURL()
           
 String getDefaultLanguage()
          return the language of the default document
 String getDefaultTemplate()
           
 String getDisplayTitle()
          Get document title.
protected  com.xpn.xwiki.doc.XWikiDocument getDoc()
          Get a clone of the XWikiDocument wrapped by this API.
 com.xpn.xwiki.doc.XWikiDocument getDocument()
          Get the XWikiDocument wrapped by this API.
 com.xpn.xwiki.doc.XWikiDocumentArchive getDocumentArchive()
          Get the archive of this document's history.
 org.xwiki.model.reference.DocumentReference getDocumentReference()
           
 Document getDocumentRevision(String revision)
          Allow to easily access any revision of a document
 String getEditURL(String action, String mode)
           
 String getEditURL(String action, String mode, String language)
           
 String getEscapedContent()
          Get the document's content XML-escaped.
 String getExternalURL()
          Get the external URL to do a given action on this document.
 String getExternalURL(String action)
          Get the external URL to do a given action on this document.
 String getExternalURL(String action, String queryString)
          Get the URL to do a given action on this document.
 Object getFirstObject(String fieldname)
           
 String getFormat()
           
 String getFullName()
          Get the fullName of the document.
 long getId()
          return the ID of the document.
 List<String> getIncludedMacros()
           
 List<String> getIncludedPages()
           
 String getLanguage()
          Get the language of the document.
 List<org.suigeneris.jrcs.diff.delta.Delta> getLastChanges()
           
 List<String> getLinkedPages()
           
 List<com.xpn.xwiki.doc.XWikiLink> getLinks()
           
 boolean getLocked()
           
 Date getLockingDate()
           
 String getLockingUser()
           
 List<com.xpn.xwiki.doc.MetaDataDiff> getMetaDataDiff(Document origdoc, Document newdoc)
           
 String getName()
          return the name of a document.
 Object getObject(String classname)
           
 Object getObject(String classname, boolean create)
          get the object of the given className.
 Object getObject(String classname, int nb)
           
 Object getObject(String classname, String key, String value)
           
 Object getObject(String classname, String key, String value, boolean failover)
           
 List<List<com.xpn.xwiki.objects.ObjectDiff>> getObjectDiff(Document origdoc, Document newdoc)
           
 int getObjectNumbers(String classname)
           
 Vector<Object> getObjects(String className)
           
 Vector<Object> getObjects(String classname, String key, String value)
          Select a subset of objects from a given class, filtered on a "key = value" criteria.
 String getParent()
          Get the name of the parent of this document.
 String getParentURL()
           
 String getPlainTitle()
           
 String getPrefixedFullName()
          Get the complete fullName of the document.
 Document getPreviousDocument()
          Allow to easily access the previous revision of a document
 String getPreviousVersion()
          Get a string representing the previous version of the document.
 org.suigeneris.jrcs.rcs.Version getRCSVersion()
          Get a Version object representing the current version of the document.
 String getRealLanguage()
          return the real language of the document
 String[] getRecentRevisions()
           
 String[] getRecentRevisions(int nb)
           
 String getRenderedContent()
           
 String getRenderedContent(String text)
          Deprecated. since 1.6M1 use getRenderedContent(String, String)
 String getRenderedContent(String text, String syntaxId)
           
 String getRenderedContent(String text, String sourceSyntaxId, String targetSyntaxId)
           
 String getRenderedContent(org.xwiki.rendering.syntax.Syntax targetSyntax)
           
 List<org.suigeneris.jrcs.diff.delta.Delta> getRenderedContentDiff(Document origdoc, Document newdoc)
           
 String getRenderedTitle(String syntaxId)
           
 RevisionInfo getRevisionInfo(String version)
          Get information about a document version : author, date, etc.
 org.suigeneris.jrcs.rcs.Version[] getRevisions()
           
 List<String> getRevisions(com.xpn.xwiki.criteria.impl.RevisionCriteria criteria)
          Get document versions matching criterias like author, minimum creation date, etc.
 List<DocumentSection> getSections()
          Get the top sections contained in the document.
 String getSpace()
          return the name of the space of the document for example if the fullName of a document is "MySpace.Mydoc", the name is MySpace.
 org.xwiki.rendering.syntax.Syntax getSyntax()
           
 String getSyntaxId()
          Deprecated. since 2.3M1 use getSyntax() instead
 List<String> getTagList()
           
 String getTags()
           
 List<String> getTagsPossibleValues()
           
 String getTemplate()
           
 String getTextArea()
           
 String getTitle()
          Get the value of the title field of the document.
 Map<String,Map<String,Object>> getTOC(int init, int max, boolean numbered)
          Returns data needed for a generation of Table of Content for this document.
 String getTranslatedContent()
           
 String getTranslatedContent(String language)
           
 Document getTranslatedDocument()
           
 Document getTranslatedDocument(String language)
           
 List<String> getTranslationList()
           
 String getURL()
          Get the URL of this document.
 String getURL(String action)
          Get the URL to do a given action on this document.
 String getURL(String action, String queryString)
          Get the URL to do a given action on this document.
 String getValidationScript()
          Retrieves the validation script associated with this document, a Velocity script that is executed when validating the document data.
 Object getValue(String fieldName)
           
 Object getValue(String fieldName, Object object)
           
 String getVersion()
          Get a string representing the current version of the document.
 String getVersionHashCode()
           
 String getWeb()
          Deprecated. use getSpace() instead of this function.
 String getWiki()
          Get the name wiki where the document is stored.
 String getXMLContent()
           
 List<org.suigeneris.jrcs.diff.delta.Delta> getXMLDiff(Document origdoc, Document newdoc)
           
protected  Vector<Object> getXObjects(List<com.xpn.xwiki.objects.BaseObject> objects)
           
 Class getxWikiClass()
           
 Class[] getxWikiClasses()
           
 Map<String,Vector<Object>> getxWikiObjects()
           
 boolean hasAccessLevel(String level)
           
 boolean hasAccessLevel(String level, String user)
          Check if the current user has an access level on a given document.
 void insertText(String text, String marker)
           
 boolean isAdvancedContent()
           
 boolean isCreator(String username)
           
 boolean isCurrentLocalUserPage()
           
 boolean isCurrentUserCreator()
           
 boolean isCurrentUserPage()
           
 boolean isFromCache()
           
 boolean isMinorEdit()
           
 boolean isMostRecent()
           
 boolean isNew()
           
 boolean isProgrammaticContent()
           
 Object newObject(String classname)
           
 boolean removeObject(Object object)
          Remove an XObject from the document.
 boolean removeObjects(String className)
          Remove all the objects of a given type (XClass) from the document.
 void rename(org.xwiki.model.reference.DocumentReference newReference)
          Rename the current document and all the backlinks leading to it.
 void rename(org.xwiki.model.reference.DocumentReference newReference, List<org.xwiki.model.reference.DocumentReference> backlinkDocumentNames, List<org.xwiki.model.reference.DocumentReference> childDocumentNames)
          Same as rename(String, List) but the list of documents having the current document as their parent is passed in parameter.
 void rename(String newDocumentName)
          Rename the current document and all the backlinks leading to it.
 void rename(String newDocumentName, List<String> backlinkDocumentNames)
          Rename the current document and all the links pointing to it in the list of passed backlink documents.
 void rename(String newDocumentName, List<String> backlinkDocumentNames, List<String> childDocumentNames)
          Same as rename(String, List) but the list of documents having the current document as their parent is passed in parameter.
 void renameDocument(String newDocumentName)
          Deprecated. use rename(String) instead
 void renameDocument(String newDocumentName, List<String> backlinkDocumentNames)
          Deprecated. use rename(String, java.util.List) instead
 void save()
           
 void save(String comment)
           
 void save(String comment, boolean minorEdit)
           
 void saveAsAuthor()
          Save the document if the content author of the script calling this method has permission to do so.
 void saveAsAuthor(String comment)
          Save the document if the content author of the script calling this method has permission to do so.
 void saveAsAuthor(String comment, boolean minorEdit)
          Save the document if the content author of the script calling this method has permission to do so.
protected  void saveDocument(String comment, boolean minorEdit)
           
 void saveWithProgrammingRights()
           
 void saveWithProgrammingRights(String comment)
           
 void saveWithProgrammingRights(String comment, boolean minorEdit)
           
 void set(String fieldname, Object value)
           
 void set(String fieldname, Object value, Object obj)
           
 void setComment(String comment)
           
 void setContent(String content)
           
 void setCustomClass(String customClass)
           
 void setDefaultTemplate(String dtemplate)
           
 void setMinorEdit(boolean isMinor)
           
 void setParent(String parent)
           
 void setSyntax(org.xwiki.rendering.syntax.Syntax syntax)
           
 void setSyntaxId(String syntaxId)
           
 void setTitle(String title)
           
 void setValidationScript(String validationScript)
          Sets a new validation script for this document, a Velocity script that is executed when validating the document data.
 String toString()
          
 String toXML()
           
 org.dom4j.Document toXMLDocument()
           
 Object updateObjectFromRequest(String className)
           
 Object updateObjectFromRequest(String className, String prefix)
           
 List<Object> updateObjectsFromRequest(String className)
           
 List<Object> updateObjectsFromRequest(String className, String prefix)
           
 void use(Object object)
           
 void use(String className)
           
 void use(String className, int nb)
           
 boolean validate()
           
 boolean validate(String[] classNames)
           
 
Methods inherited from class com.xpn.xwiki.api.Api
convert, convert, getXWikiContext, hasAdminRights, hasProgrammingRights, hasWikiAdminRights
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

doc

protected com.xpn.xwiki.doc.XWikiDocument doc
The XWikiDocument object wrapped by this API.


cloned

protected boolean cloned
Indicates if this API wraps a cloned XWikiDocument.


currentObj

protected Object currentObj
Convenience object used by object related methods.

Constructor Detail

Document

public Document(com.xpn.xwiki.doc.XWikiDocument doc,
                com.xpn.xwiki.XWikiContext context)
Document constructor.

Parameters:
doc - The XWikiDocument object to wrap.
context - The current request context.
Method Detail

getDocument

public com.xpn.xwiki.doc.XWikiDocument getDocument()
Get the XWikiDocument wrapped by this API. This function is accessible only if you have the programming rights give access to the priviledged API of the Document.

Returns:
The XWikiDocument wrapped by this API.

getDoc

protected com.xpn.xwiki.doc.XWikiDocument getDoc()
Get a clone of the XWikiDocument wrapped by this API.

Returns:
A clone of the XWikiDocument wrapped by this API.

getId

public long getId()
return the ID of the document. this ID is unique across the wiki.

Returns:
the id of the document.

getDocumentReference

public org.xwiki.model.reference.DocumentReference getDocumentReference()
Since:
2.3M1

getName

public String getName()
return the name of a document. for exemple if the fullName of a document is "MySpace.Mydoc", the name is MyDoc.

Returns:
the name of the document

getSpace

public String getSpace()
return the name of the space of the document for example if the fullName of a document is "MySpace.Mydoc", the name is MySpace.

Returns:
the name of the space of the document

getWiki

public String getWiki()
Get the name wiki where the document is stored.

Returns:
The name of the wiki where this document is stored.
Since:
XWiki Core 1.1.2, XWiki Core 1.2M2

getWeb

@Deprecated
public String getWeb()
Deprecated. use getSpace() instead of this function.

Get the name of the space of the document for exemple if the fullName of a document is "MySpace.Mydoc", the name is MySpace.

Returns:
The name of the space of the document.

getFullName

public String getFullName()
Get the fullName of the document. If a document is named "MyDoc" in space "MySpace", the fullname is "MySpace.MyDoc". In a wiki, all the documents have a different fullName.

Returns:
fullName of the document.

getPrefixedFullName

public String getPrefixedFullName()
Get the complete fullName of the document. The real full name of the document containing the name of the wiki where the document is stored. For a document stored in the wiki "xwiki", in space "MySpace", named "MyDoc", its complete full name is "xwiki:MySpace.MyDoc".

Returns:
The complete fullName of the document.
Since:
XWiki Core 1.1.2, XWiki Core 1.2M2

getRCSVersion

public org.suigeneris.jrcs.rcs.Version getRCSVersion()
Get a Version object representing the current version of the document.

Returns:
A Version object representing the current version of the document

getVersion

public String getVersion()
Get a string representing the current version of the document.

Returns:
A string representing the current version of the document.

getPreviousVersion

public String getPreviousVersion()
Get a string representing the previous version of the document.

Returns:
A string representing the previous version of the document. If this is the first version then it returns null.

getTitle

public String getTitle()
Get the value of the title field of the document.

Returns:
The value of the title field of the document.

getDisplayTitle

public String getDisplayTitle()
Get document title. If a title has not been provided through the title field, it looks for a section title in the document's content and if not found return the page name. The returned title is also interpreted which means it's allowed to use Velocity, Groovy, etc syntax within a title.

Returns:
The document title as XHTML

getPlainTitle

public String getPlainTitle()
Returns:
the document title as plain text (all markup removed)
Since:
3.0M1

getRenderedTitle

public String getRenderedTitle(String syntaxId)
                        throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException
See Also:
XWikiDocument.getRenderedTitle(Syntax, XWikiContext)

getFormat

public String getFormat()

getAuthor

public String getAuthor()
Get fullName of the profile document of the author of the current version of the document. Example: XWiki.Admin.

Returns:
The fullName of the profile document of the author of the current version of the document.

getContentAuthor

public String getContentAuthor()
Get fullName of the profile document of the author of the last content modification in the document. Example: XWiki.Admin.

Returns:
The fullName of the profile document of the author of the last content modification in the document.

getDate

public Date getDate()
Get the date when the current document version has been created, i.e. the date of the last modification of the document.

Returns:
The date where the current document version has been created.

getContentUpdateDate

public Date getContentUpdateDate()
Get the date when the last content modification has been done on the document.

Returns:
The date where the last content modification has been done on the document.

getCreationDate

public Date getCreationDate()
Get the date when the document has been created. return The date when the document has been created.


getParent

public String getParent()
Get the name of the parent of this document.

Returns:
The name of the parent of this document.

getCreator

public String getCreator()
Get fullName of the profile document of the document creator.

Returns:
The fullName of the profile document of the document creator.

getContent

public String getContent()
Get raw content of the document, i.e. the content that is visible through the wiki editor.

Returns:
The raw content of the document.

getSyntax

public org.xwiki.rendering.syntax.Syntax getSyntax()
Returns:
The syntax representing the syntax used for the document's content
Since:
2.3M1

getSyntaxId

@Deprecated
public String getSyntaxId()
Deprecated. since 2.3M1 use getSyntax() instead

Get the Syntax id representing the syntax used for the document. For example "xwiki/1.0" represents the first version XWiki syntax while "xwiki/2.0" represents version 2.0 of the XWiki Syntax.

Returns:
The syntax id representing the syntax used for the document.

getLanguage

public String getLanguage()
Get the language of the document. If the document is a translation it returns the language set for it, otherwise, it returns the default language in the wiki where the document is stored.

Returns:
The language of the document.

getTemplate

public String getTemplate()

getRealLanguage

public String getRealLanguage()
                       throws com.xpn.xwiki.XWikiException
return the real language of the document

Throws:
com.xpn.xwiki.XWikiException

getDefaultLanguage

public String getDefaultLanguage()
return the language of the default document


getDefaultTemplate

public String getDefaultTemplate()

getComment

public String getComment()
Returns:
the comment of the latest update of the document.

isMinorEdit

public boolean isMinorEdit()
Returns:
true if the last change to this document was a minor edit.

getTranslationList

public List<String> getTranslationList()
                                throws com.xpn.xwiki.XWikiException
Returns:
the list of existing translations for this document.
Throws:
com.xpn.xwiki.XWikiException

getTranslatedContent

public String getTranslatedContent()
                            throws com.xpn.xwiki.XWikiException
Returns:
the translated document's content if the wiki is multilingual, the language is first checked in the URL, the cookie, the user profile and finally the wiki configuration if not, the language is the one on the wiki configuration.
Throws:
com.xpn.xwiki.XWikiException

getTranslatedContent

public String getTranslatedContent(String language)
                            throws com.xpn.xwiki.XWikiException
Returns:
the translated content in the given language
Throws:
com.xpn.xwiki.XWikiException

getTranslatedDocument

public Document getTranslatedDocument(String language)
                               throws com.xpn.xwiki.XWikiException
Returns:
the translated document in the given document
Throws:
com.xpn.xwiki.XWikiException

getTranslatedDocument

public Document getTranslatedDocument()
                               throws com.xpn.xwiki.XWikiException
Returns:
the tranlated Document if the wiki is multilingual, the language is first checked in the URL, the cookie, the user profile and finally the wiki configuration if not, the language is the one on the wiki configuration.
Throws:
com.xpn.xwiki.XWikiException

getRenderedContent

public String getRenderedContent()
                          throws com.xpn.xwiki.XWikiException
Returns:
the content of the document rendered.
Throws:
com.xpn.xwiki.XWikiException

getRenderedContent

@Deprecated
public String getRenderedContent(String text)
                          throws com.xpn.xwiki.XWikiException
Deprecated. since 1.6M1 use getRenderedContent(String, String)

Parameters:
text - the text to render
Returns:
the given text rendered in the context of this document
Throws:
com.xpn.xwiki.XWikiException

getRenderedContent

public String getRenderedContent(String text,
                                 String syntaxId)
                          throws com.xpn.xwiki.XWikiException
Parameters:
text - the text to render
syntaxId - the id of the Syntax used by the passed text (for example: "xwiki/1.0")
Returns:
the given text rendered in the context of this document using the passed Syntax
Throws:
com.xpn.xwiki.XWikiException
Since:
1.6M1

getRenderedContent

public String getRenderedContent(String text,
                                 String sourceSyntaxId,
                                 String targetSyntaxId)
                          throws com.xpn.xwiki.XWikiException
Parameters:
text - the text to render
sourceSyntaxId - the id of the Syntax used by the passed text (for example: "xwiki/1.0")
targetSyntaxId - the id of the syntax in which to render the document content
Returns:
the given text rendered in the context of this document using the passed Syntax
Throws:
com.xpn.xwiki.XWikiException
Since:
2.0M3

getRenderedContent

public String getRenderedContent(org.xwiki.rendering.syntax.Syntax targetSyntax)
                          throws com.xpn.xwiki.XWikiException
Parameters:
targetSyntax - the syntax in which to render the document content
Returns:
the rendered content
Throws:
com.xpn.xwiki.XWikiException - error when rendering content

getEscapedContent

public String getEscapedContent()
                         throws com.xpn.xwiki.XWikiException
Get the document's content XML-escaped.

Returns:
an XML-escaped version of the content of this document.
Throws:
com.xpn.xwiki.XWikiException

getArchive

public String getArchive()
                  throws com.xpn.xwiki.XWikiException
Returns:
the archive of the document in a string format.
Throws:
com.xpn.xwiki.XWikiException

getDocumentArchive

public com.xpn.xwiki.doc.XWikiDocumentArchive getDocumentArchive()
                                                          throws com.xpn.xwiki.XWikiException
Get the archive of this document's history. This function is accessible only if you have the programming rights.

Returns:
the archive of this document's history as an XWikiDocumentArchive.
Throws:
com.xpn.xwiki.XWikiException

isNew

public boolean isNew()
Returns:
true if the document is a new one (ie it has never been saved) or false otherwise

getAttachmentURL

public String getAttachmentURL(String filename)
Return the URL of download for the the given attachment name.

Parameters:
filename - the name of the attachment
Returns:
A String with the URL

getAttachmentURL

public String getAttachmentURL(String filename,
                               String action)
Get the URL of the given action for the the given attachment name.

Parameters:
filename - the name of the attachment.
action - what to do to the file for example "delattachment", "download" or "downloadrev".
Returns:
a string representation of a URL to do the given opperation.

getAttachmentURL

public String getAttachmentURL(String filename,
                               String action,
                               String queryString)
Get the URL of an action on an attachment. the given action for the the given attachment name with "queryString" parameters

Parameters:
filename - the name of the attachment.
action - what to do to the file for example "delattachment", "download" or "downloadrev"
queryString - parameters added to the URL, the "rev" parameter is used to specify a revision if using the "downloadrev" action. The query string must not begin with an ? character.
Returns:
a string representation of a URL to do the given opperation.

getAttachmentRevisionURL

public String getAttachmentRevisionURL(String filename,
                                       String version)
Get an old revision of an attachment.

Parameters:
filename - the name of the attachment.
version - a revision number such as "1.1" or "1.2".
Returns:
the URL for accessing to the archive of the attachment "filename" at the version "version"

getAttachmentRevisionURL

public String getAttachmentRevisionURL(String filename,
                                       String version,
                                       String queryString)
Get an old revision of an attachment.

Parameters:
filename - the name of the attachment.
version - a revision number such as "1.1" or "1.2".
queryString - additional query parameters to pass in the request.
Returns:
the URL for accessing to the archive of the attachment "filename" at the version "version" with the given queryString parameters.

getURL

public String getURL()
Get the URL of this document.

Returns:
the URL to view this document, this will be a relitive URL for example: /xwiki/bin/view/Main/WebHome
See Also:
for an absolute URL which can used outside of the site.

getURL

public String getURL(String action)
Get the URL to do a given action on this document.

Parameters:
action - what to do to the document for example "view", "edit" or "inline".
Returns:
the URL of this document with the given action.
See Also:
for an absolute URL which can used outside of the site.

getURL

public String getURL(String action,
                     String queryString)
Get the URL to do a given action on this document.

Parameters:
action - what to do to the document for example "view", "edit" or "inline".
queryString - parameters to pass in the request eg: "paramA=value1¶mB=value2"
Returns:
the URL of this document with the given action and queryString as parameters.
See Also:
for an absolute URL which can used outside of the site.

getExternalURL

public String getExternalURL()
Get the external URL to do a given action on this document.

Returns:
the full URL of the document, sutable for use at external websites for example: http://www.xwiki.org/xwiki/bin/view/Main/WebHome
See Also:
for a reletive URL which can only be used inside of the site.

getExternalURL

public String getExternalURL(String action)
Get the external URL to do a given action on this document.

Parameters:
action - what to do to the document for example "view", "edit" or "inline".
Returns:
the URL of this document with the given action.
See Also:
for a relative URL which can only be used inside of the site.

getExternalURL

public String getExternalURL(String action,
                             String queryString)
Get the URL to do a given action on this document.

Parameters:
action - what to do to the document for example "view", "edit" or "inline".
queryString - parameters to pass in the request eg: "paramA=value1¶mB=value2"
Returns:
the URL of this document with the given action and queryString as parameters.
See Also:
for a relative URL which can only be used inside of the site.

getParentURL

public String getParentURL()
                    throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

getxWikiClass

public Class getxWikiClass()

getxWikiClasses

public Class[] getxWikiClasses()

createNewObject

public int createNewObject(String classname)
                    throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

newObject

public Object newObject(String classname)
                 throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

isFromCache

public boolean isFromCache()

getObjectNumbers

public int getObjectNumbers(String classname)

getxWikiObjects

public Map<String,Vector<Object>> getxWikiObjects()

getXObjects

protected Vector<Object> getXObjects(List<com.xpn.xwiki.objects.BaseObject> objects)

getObjects

public Vector<Object> getObjects(String className)

getFirstObject

public Object getFirstObject(String fieldname)

getObject

public Object getObject(String classname,
                        String key,
                        String value,
                        boolean failover)

getObjects

public Vector<Object> getObjects(String classname,
                                 String key,
                                 String value)
Select a subset of objects from a given class, filtered on a "key = value" criteria.

Parameters:
classname - The type of objects to return.
key - The name of the property used for filtering.
value - The required value.
Returns:
A Vector of objects matching the criteria. If no objects are found, or if the key is an empty String, then an empty vector is returned.

getObject

public Object getObject(String classname,
                        String key,
                        String value)

getObject

public Object getObject(String classname)

getObject

public Object getObject(String classname,
                        boolean create)
get the object of the given className. If there is no object of this className and the create parameter at true, the object is created.


getObject

public Object getObject(String classname,
                        int nb)

getXMLContent

public String getXMLContent()
                     throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

toXML

public String toXML()
             throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

toXMLDocument

public org.dom4j.Document toXMLDocument()
                                 throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

getRevisions

public org.suigeneris.jrcs.rcs.Version[] getRevisions()
                                               throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

getRecentRevisions

public String[] getRecentRevisions()
                            throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

getRecentRevisions

public String[] getRecentRevisions(int nb)
                            throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

getRevisions

public List<String> getRevisions(com.xpn.xwiki.criteria.impl.RevisionCriteria criteria)
                          throws com.xpn.xwiki.XWikiException
Get document versions matching criterias like author, minimum creation date, etc.

Parameters:
criteria - criteria used to match versions
Returns:
a list of matching versions
Throws:
com.xpn.xwiki.XWikiException

getRevisionInfo

public RevisionInfo getRevisionInfo(String version)
                             throws com.xpn.xwiki.XWikiException
Get information about a document version : author, date, etc.

Parameters:
version - the version you want to get information about
Returns:
a new RevisionInfo object
Throws:
com.xpn.xwiki.XWikiException

getAttachmentList

public List<Attachment> getAttachmentList()

getComments

public Vector<Object> getComments()

getComments

public Vector<Object> getComments(boolean asc)

use

public void use(Object object)

use

public void use(String className)

use

public void use(String className,
                int nb)

getActiveClass

public String getActiveClass()

displayPrettyName

public String displayPrettyName(String fieldname)

displayPrettyName

public String displayPrettyName(String fieldname,
                                Object obj)

displayPrettyName

public String displayPrettyName(String fieldname,
                                boolean showMandatory)

displayPrettyName

public String displayPrettyName(String fieldname,
                                boolean showMandatory,
                                Object obj)

displayPrettyName

public String displayPrettyName(String fieldname,
                                boolean showMandatory,
                                boolean before)

displayPrettyName

public String displayPrettyName(String fieldname,
                                boolean showMandatory,
                                boolean before,
                                Object obj)

displayTooltip

public String displayTooltip(String fieldname)

displayTooltip

public String displayTooltip(String fieldname,
                             Object obj)

display

public String display(String fieldname)

display

public String display(String fieldname,
                      String mode)

display

public String display(String fieldname,
                      String mode,
                      String prefix)

display

public String display(String fieldname,
                      Object obj)

display

public String display(String fieldname,
                      String type,
                      Object obj,
                      String wrappingSyntaxId)
Parameters:
fieldname - the name of the field to display
type - the type of the field to display
obj - the object containing the field to display
wrappingSyntaxId - the syntax of the content in which the result will be included. This to take care of some escaping depending of the syntax.
Returns:
the rendered field

display

public String display(String fieldname,
                      String mode,
                      Object obj)

display

public String display(String fieldname,
                      String mode,
                      String prefix,
                      Object obj)

displayForm

public String displayForm(String className,
                          String header,
                          String format)

displayForm

public String displayForm(String className,
                          String header,
                          String format,
                          boolean linebreak)

displayForm

public String displayForm(String className)

displayRendered

public String displayRendered(PropertyClass pclass,
                              String prefix,
                              Collection object)
                       throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

displayView

public String displayView(PropertyClass pclass,
                          String prefix,
                          Collection object)

displayEdit

public String displayEdit(PropertyClass pclass,
                          String prefix,
                          Collection object)

displayHidden

public String displayHidden(PropertyClass pclass,
                            String prefix,
                            Collection object)

getIncludedPages

public List<String> getIncludedPages()

getIncludedMacros

public List<String> getIncludedMacros()

getLinkedPages

public List<String> getLinkedPages()

getAttachment

public Attachment getAttachment(String filename)

getContentDiff

public List<org.suigeneris.jrcs.diff.delta.Delta> getContentDiff(Document origdoc,
                                                                 Document newdoc)
                                                          throws com.xpn.xwiki.XWikiException,
                                                                 org.suigeneris.jrcs.diff.DifferentiationFailedException
Throws:
com.xpn.xwiki.XWikiException
org.suigeneris.jrcs.diff.DifferentiationFailedException

getXMLDiff

public List<org.suigeneris.jrcs.diff.delta.Delta> getXMLDiff(Document origdoc,
                                                             Document newdoc)
                                                      throws com.xpn.xwiki.XWikiException,
                                                             org.suigeneris.jrcs.diff.DifferentiationFailedException
Throws:
com.xpn.xwiki.XWikiException
org.suigeneris.jrcs.diff.DifferentiationFailedException

getRenderedContentDiff

public List<org.suigeneris.jrcs.diff.delta.Delta> getRenderedContentDiff(Document origdoc,
                                                                         Document newdoc)
                                                                  throws com.xpn.xwiki.XWikiException,
                                                                         org.suigeneris.jrcs.diff.DifferentiationFailedException
Throws:
com.xpn.xwiki.XWikiException
org.suigeneris.jrcs.diff.DifferentiationFailedException

getMetaDataDiff

public List<com.xpn.xwiki.doc.MetaDataDiff> getMetaDataDiff(Document origdoc,
                                                            Document newdoc)
                                                     throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

getObjectDiff

public List<List<com.xpn.xwiki.objects.ObjectDiff>> getObjectDiff(Document origdoc,
                                                                  Document newdoc)

getClassDiff

public List<List<com.xpn.xwiki.objects.ObjectDiff>> getClassDiff(Document origdoc,
                                                                 Document newdoc)

getAttachmentDiff

public List<com.xpn.xwiki.doc.AttachmentDiff> getAttachmentDiff(Document origdoc,
                                                                Document newdoc)

getLastChanges

public List<org.suigeneris.jrcs.diff.delta.Delta> getLastChanges()
                                                          throws com.xpn.xwiki.XWikiException,
                                                                 org.suigeneris.jrcs.diff.DifferentiationFailedException
Throws:
com.xpn.xwiki.XWikiException
org.suigeneris.jrcs.diff.DifferentiationFailedException

getCurrentMonthPageStats

public com.xpn.xwiki.stats.impl.DocumentStats getCurrentMonthPageStats(String action)
Get statistics about the number of request for the current page during the current month.

Parameters:
action - the type of request for which to retrieve statistics: view, edit...
Returns:
the statistics object holding information for this document and the current month

getCurrentMonthSpaceStats

public com.xpn.xwiki.stats.impl.DocumentStats getCurrentMonthSpaceStats(String action)
Get statistics about the number of request for the current space during the current month.

Parameters:
action - the type of request for which to retrieve statistics: view, edit...
Returns:
the statistics object holding information for the document's space and the current month

getCurrentMonthRefStats

public List<com.xpn.xwiki.stats.impl.RefererStats> getCurrentMonthRefStats()
Get referer statistics for the current document during the current month.

Returns:
a list of referer statistics for the document's space

checkAccess

public boolean checkAccess(String right)

hasAccessLevel

public boolean hasAccessLevel(String level)

hasAccessLevel

public boolean hasAccessLevel(String level,
                              String user)
Description copied from class: Api
Check if the current user has an access level on a given document.

Overrides:
hasAccessLevel in class Api
Parameters:
level - The name of the right to verify (eg "programming", "admin", "register", etc).
user - The document for which to verify the right.
Returns:
true if the current user has the specified right, false otherwise.

getLocked

public boolean getLocked()

getLockingUser

public String getLockingUser()

getLockingDate

public Date getLockingDate()

get

public Object get(String classOrFieldName)

getValue

public Object getValue(String fieldName)

getValue

public Object getValue(String fieldName,
                       Object object)

getTextArea

public String getTextArea()

getTOC

public Map<String,Map<String,Object>> getTOC(int init,
                                             int max,
                                             boolean numbered)
Returns data needed for a generation of Table of Content for this document.

Parameters:
init - an intial level where the TOC generation should start at
max - maximum level TOC is generated for
numbered - if should generate numbering for headings
Returns:
a map where an heading (title) ID is the key and value is another map with two keys: text, level and numbering

getTags

public String getTags()

getTagList

public List<String> getTagList()

getTagsPossibleValues

public List<String> getTagsPossibleValues()

insertText

public void insertText(String text,
                       String marker)
                throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

equals

public boolean equals(Object arg0)
Overrides:
equals in class Object

getBacklinks

public List<String> getBacklinks()
                          throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

getLinks

public List<com.xpn.xwiki.doc.XWikiLink> getLinks()
                                           throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

getSections

public List<DocumentSection> getSections()
                                  throws com.xpn.xwiki.XWikiException
Get the top sections contained in the document.

The section are filtered by xwiki.section.depth property on the maximum depth of the sections to return. This method is usually used to get "editable" sections.

Returns:
the sections in the current document
Throws:
com.xpn.xwiki.XWikiException

getChildren

public List<String> getChildren()
                         throws com.xpn.xwiki.XWikiException
Get document children. Children are documents with the current document as parent.

Returns:
The list of children for the current document.
Throws:
com.xpn.xwiki.XWikiException
Since:
1.8 Milestone 2

getChildren

public List<String> getChildren(int nb,
                                int start)
                         throws com.xpn.xwiki.XWikiException
Get document children. Children are documents with the current document as parent. Where a document has a large number of children, one may desire to return a certain number of children (nb) and skip some number (start) of the first results.

Parameters:
nb - The number of results to return.
start - The number of results to skip before we begin returning results.
Returns:
The list of children for the current document.
Throws:
com.xpn.xwiki.XWikiException

getDefaultEditMode

public String getDefaultEditMode()
                          throws com.xpn.xwiki.XWikiException
Returns:
"inline" if the document should be edited in inline mode by default or "edit" otherwise.
Throws:
com.xpn.xwiki.XWikiException - if an error happens when computing the edit mode

getDefaultEditURL

public String getDefaultEditURL()
                         throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

getEditURL

public String getEditURL(String action,
                         String mode)
                  throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

getEditURL

public String getEditURL(String action,
                         String mode,
                         String language)

isCurrentUserCreator

public boolean isCurrentUserCreator()

isCurrentUserPage

public boolean isCurrentUserPage()

isCurrentLocalUserPage

public boolean isCurrentLocalUserPage()

isCreator

public boolean isCreator(String username)

set

public void set(String fieldname,
                Object value)

set

public void set(String fieldname,
                Object value,
                Object obj)

setTitle

public void setTitle(String title)

setCustomClass

public void setCustomClass(String customClass)

setParent

public void setParent(String parent)

setContent

public void setContent(String content)

setSyntax

public void setSyntax(org.xwiki.rendering.syntax.Syntax syntax)
Parameters:
syntax - the Syntax representing the syntax used for the current document's content.
Since:
2.3M1

setSyntaxId

public void setSyntaxId(String syntaxId)
Parameters:
syntaxId - the Syntax id representing the syntax used for the current document. For example "xwiki/1.0" represents the first version XWiki syntax while "xwiki/2.0" represents version 2.0 of the XWiki Syntax.

setDefaultTemplate

public void setDefaultTemplate(String dtemplate)

setComment

public void setComment(String comment)

setMinorEdit

public void setMinorEdit(boolean isMinor)

save

public void save()
          throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

save

public void save(String comment)
          throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

save

public void save(String comment,
                 boolean minorEdit)
          throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

saveWithProgrammingRights

public void saveWithProgrammingRights()
                               throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

saveWithProgrammingRights

public void saveWithProgrammingRights(String comment)
                               throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

saveWithProgrammingRights

public void saveWithProgrammingRights(String comment,
                                      boolean minorEdit)
                               throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

saveAsAuthor

public void saveAsAuthor()
                  throws com.xpn.xwiki.XWikiException
Save the document if the content author of the script calling this method has permission to do so. The author of this document is also set to the said content author.

Throws:
com.xpn.xwiki.XWikiException - if script author is not allowed to save the document or if save operation fails.
Since:
2.3M2

saveAsAuthor

public void saveAsAuthor(String comment)
                  throws com.xpn.xwiki.XWikiException
Save the document if the content author of the script calling this method has permission to do so. The author of this document is also set to the said content author.

Parameters:
comment - The comment to display in document history (what did you change in the document)
Throws:
com.xpn.xwiki.XWikiException - if script author is not allowed to save the document or if save operation fails.
Since:
2.3M2

saveAsAuthor

public void saveAsAuthor(String comment,
                         boolean minorEdit)
                  throws com.xpn.xwiki.XWikiException
Save the document if the content author of the script calling this method has permission to do so. The author of this document is also set to the said content author.

Parameters:
comment - The comment to display in document history (what did you change in the document)
minorEdit - Set true to advance the document version number by 0.1 or false to advance version to the next integer + 0.1 eg: 25.1
Throws:
com.xpn.xwiki.XWikiException - if script author is not allowed to save the document or if save operation fails.
Since:
2.3M2

saveDocument

protected void saveDocument(String comment,
                            boolean minorEdit)
                     throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

addObjectFromRequest

public Object addObjectFromRequest()
                            throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

addObjectFromRequest

public Object addObjectFromRequest(String className)
                            throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

addObjectsFromRequest

public List<Object> addObjectsFromRequest(String className)
                                   throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

addObjectFromRequest

public Object addObjectFromRequest(String className,
                                   String prefix)
                            throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

addObjectsFromRequest

public List<Object> addObjectsFromRequest(String className,
                                          String prefix)
                                   throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

updateObjectFromRequest

public Object updateObjectFromRequest(String className)
                               throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

updateObjectsFromRequest

public List<Object> updateObjectsFromRequest(String className)
                                      throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

updateObjectFromRequest

public Object updateObjectFromRequest(String className,
                                      String prefix)
                               throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

updateObjectsFromRequest

public List<Object> updateObjectsFromRequest(String className,
                                             String prefix)
                                      throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

isAdvancedContent

public boolean isAdvancedContent()

isProgrammaticContent

public boolean isProgrammaticContent()

removeObject

public boolean removeObject(Object object)
Remove an XObject from the document. The changes are not persisted until the document is saved.

Parameters:
object - the object to remove
Returns:
true if the object was successfully removed, false if the object was not found in the current document.

removeObjects

public boolean removeObjects(String className)
Remove all the objects of a given type (XClass) from the document. The object counter is left unchanged, so that future objects will have new (different) numbers. However, on some storage engines the counter will be reset if the document is removed from the cache and reloaded from the persistent storage.

Parameters:
className - The class name of the objects to be removed.
Returns:
true if the objects were successfully removed, false if no object from the target class was in the current document.

deleteDocument

protected void deleteDocument()
                       throws com.xpn.xwiki.XWikiException
Remove document from the wiki. Reinit cloned.

Throws:
com.xpn.xwiki.XWikiException

delete

public void delete()
            throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

deleteAsAuthor

public void deleteAsAuthor()
                    throws com.xpn.xwiki.XWikiException
Delete the document if the content author of the script calling this method has permission to do so. The deleter is also set to the said content author.

Throws:
com.xpn.xwiki.XWikiException - if script author is not allowed to delete the document or if save operation fails.
Since:
2.3M2

deleteWithProgrammingRights

public void deleteWithProgrammingRights()
                                 throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

getVersionHashCode

public String getVersionHashCode()

addAttachments

public int addAttachments()
                   throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

addAttachments

public int addAttachments(String fieldName)
                   throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

addAttachment

public Attachment addAttachment(String fileName,
                                InputStream iStream)

addAttachment

public Attachment addAttachment(String fileName,
                                byte[] data)

validate

public boolean validate()
                 throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

validate

public boolean validate(String[] classNames)
                 throws com.xpn.xwiki.XWikiException
Throws:
com.xpn.xwiki.XWikiException

getValidationScript

public String getValidationScript()
Retrieves the validation script associated with this document, a Velocity script that is executed when validating the document data.

Returns:
A String representation of the validation script, or an empty string if there is no such script.

setValidationScript

public void setValidationScript(String validationScript)
Sets a new validation script for this document, a Velocity script that is executed when validating the document data.

Parameters:
validationScript - The new validation script, which can be an empty string or null if the script should be removed.

renameDocument

@Deprecated
public void renameDocument(String newDocumentName)
                    throws com.xpn.xwiki.XWikiException
Deprecated. use rename(String) instead

Throws:
com.xpn.xwiki.XWikiException

rename

public void rename(String newDocumentName)
            throws com.xpn.xwiki.XWikiException
Rename the current document and all the backlinks leading to it. Will also change parent field in all documents which list the document we are renaming as their parent. See rename(String, java.util.List, java.util.List) for more details.

Parameters:
newDocumentName - the new document name. If the space is not specified then defaults to the current space.
Throws:
com.xpn.xwiki.XWikiException - in case of an error

rename

public void rename(org.xwiki.model.reference.DocumentReference newReference)
            throws com.xpn.xwiki.XWikiException
Rename the current document and all the backlinks leading to it. Will also change parent field in all documents which list the document we are renaming as their parent. See rename(String, java.util.List, java.util.List) for more details.

Parameters:
newReference - the reference to the new document
Throws:
com.xpn.xwiki.XWikiException - in case of an error
Since:
2.3M2

renameDocument

@Deprecated
public void renameDocument(String newDocumentName,
                                      List<String> backlinkDocumentNames)
                    throws com.xpn.xwiki.XWikiException
Deprecated. use rename(String, java.util.List) instead

Throws:
com.xpn.xwiki.XWikiException

rename

public void rename(String newDocumentName,
                   List<String> backlinkDocumentNames)
            throws com.xpn.xwiki.XWikiException
Rename the current document and all the links pointing to it in the list of passed backlink documents. The renaming algorithm takes into account the fact that there are several ways to write a link to a given page and all those forms need to be renamed. For example the following links all point to the same page:

Note: links without a space are renamed with the space added and all documents which have the document being renamed as parent have their parent field set to "currentwiki:CurrentSpace.Page".

Parameters:
newDocumentName - the new document name. If the space is not specified then defaults to the current space.
backlinkDocumentNames - the list of documents to parse and for which links will be modified to point to the new renamed document.
Throws:
com.xpn.xwiki.XWikiException - in case of an error

rename

public void rename(String newDocumentName,
                   List<String> backlinkDocumentNames,
                   List<String> childDocumentNames)
            throws com.xpn.xwiki.XWikiException
Same as rename(String, List) but the list of documents having the current document as their parent is passed in parameter.

Parameters:
newDocumentName - the new document name. If the space is not specified then defaults to the current space.
backlinkDocumentNames - the list of documents to parse and for which links will be modified to point to the new renamed document.
childDocumentNames - the list of documents whose parent field will be set to the new document name.
Throws:
com.xpn.xwiki.XWikiException - in case of an error

rename

public void rename(org.xwiki.model.reference.DocumentReference newReference,
                   List<org.xwiki.model.reference.DocumentReference> backlinkDocumentNames,
                   List<org.xwiki.model.reference.DocumentReference> childDocumentNames)
            throws com.xpn.xwiki.XWikiException
Same as rename(String, List) but the list of documents having the current document as their parent is passed in parameter.

Parameters:
newReference - the reference to the new document
backlinkDocumentNames - the list of reference to documents to parse and for which links will be modified to point to the new renamed document
childDocumentNames - the list of references to documents whose parent field will be set to the new document reference
Throws:
com.xpn.xwiki.XWikiException - in case of an error
Since:
2.3M2

getDocumentRevision

public Document getDocumentRevision(String revision)
                             throws com.xpn.xwiki.XWikiException
Allow to easily access any revision of a document

Parameters:
revision - version to access
Returns:
Document object
Throws:
com.xpn.xwiki.XWikiException

getPreviousDocument

public Document getPreviousDocument()
                             throws com.xpn.xwiki.XWikiException
Allow to easily access the previous revision of a document

Returns:
Document
Throws:
com.xpn.xwiki.XWikiException

isMostRecent

public boolean isMostRecent()
Returns:
is document most recent. false if and only if there are older versions of this document.

toString

public String toString()

Overrides:
toString in class Object
See Also:
Object.toString()

convertSyntax

public boolean convertSyntax(String targetSyntaxId)
                      throws com.xpn.xwiki.XWikiException
Convert the current document content from its current syntax to the new syntax passed as parameter.

Parameters:
targetSyntaxId - the syntax to convert to (eg "xwiki/2.0", "xhtml/1.0", etc)
Throws:
com.xpn.xwiki.XWikiException - if an exception occurred during the conversion process

dropPermissions

public void dropPermissions()
Drop permissions for the remainder of the rendering cycle. After this is called:

This sandboxing will expire at the end of the rendering cycle and can be suspended by beginning a new rendering cycle. A rendering cycle can be begin by calling getRenderedContent(String), display(String) (or variations thereof) or by invoking the include macro or using XWiki.includeTopic(String)

NOTE: Even if you include the same document, permissions will be regained. What this does is sandbox the remainder of the code on the page because although it can temporarily suspend the permissions drop, it cannot get itself to be executed with permissions because if it calls itself, it will hit the drop function first.

If you are interested in a more secure sandboxing method where code is guaranteed not to have permissions for the remainder of the request, you should consider Context.dropPermissions().

Since:
3.2M2


Copyright © 2004-2011 XWiki. All Rights Reserved.