org.opencms.xml.page

类 CmsXmlPageFactory

java.lang.Object

org.opencms.xml.page.CmsXmlPageFactory

public final class CmsXmlPageFactory
extends java.lang.Object

Provides factory methods to unmarshal (read) an XML page object.

从以下版本开始:

6.0.0

方法概要

方法

限定符和类型	方法和说明
static org.dom4j.Document	createDocument(java.util.Locale locale) Creates a valid XML page document, containing one empty element in the given locale.
static java.lang.String	createDocument(java.util.Locale locale, java.lang.String encoding) Creates a valid XML page String representation, containing one empty element in the given locale.
static CmsXmlPage	unmarshal(byte[] xmlData, java.lang.String encoding, org.xml.sax.EntityResolver resolver) Factory method to unmarshal (read) a XML page instance from a byte array that contains XML data.
static CmsXmlPage	unmarshal(CmsObject cms, CmsFile file) Factory method to unmarshal (read) a XML page instance from a OpenCms VFS file that contains XML data.
static CmsXmlPage	unmarshal(CmsObject cms, CmsFile file, boolean keepEncoding) Factory method to unmarshal (read) a XML page instance from a OpenCms VFS file that contains XML data, using wither the encoding set in the XML file header, or the encoding set in the VFS file property.
static CmsXmlPage	unmarshal(CmsObject cms, CmsResource resource, javax.servlet.ServletRequest req) Factory method to unmarshal (read) a XML page instance from a resource, using the request attributes as cache.
static I_CmsXmlDocument	unmarshal(CmsObject cms, java.lang.String filename, javax.servlet.ServletRequest req) Factory method to unmarshal (read) a XML document instance from a filename in the VFS, using the request attributes as cache.
static CmsXmlPage	unmarshal(java.lang.String xmlData, java.lang.String encoding, org.xml.sax.EntityResolver resolver) Factory method to unmarshal (read) a XML page instance from a String that contains XML data.

从类继承的方法 java.lang.Object

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

方法详细资料

createDocument

public static org.dom4j.Document createDocument(java.util.Locale locale)

Creates a valid XML page document, containing one empty element in the given locale.

参数:

locale - the locale to create the XML page for

返回:

a valid XML page document

createDocument

public static java.lang.String createDocument(java.util.Locale locale,
                              java.lang.String encoding)

Creates a valid XML page String representation, containing one empty element in the given locale.

参数:

locale - the locale to create the XML page for

encoding - the encoding to use when creating the String from the XML

返回:

a valid XML page document as a String

unmarshal

public static CmsXmlPage unmarshal(byte[] xmlData,
                   java.lang.String encoding,
                   org.xml.sax.EntityResolver resolver)
                            throws CmsXmlException

Factory method to unmarshal (read) a XML page instance from a byte array that contains XML data.

When unmarshalling, the encoding is read directly from the XML header. The given encoding is used only when marshalling the XML again later.

参数:

xmlData - the XML data in a byte array

encoding - the encoding to use when marshalling the XML page later

resolver - the XML entity resolver to use

返回:

a XML page instance unmarshalled from the byte array

抛出:

CmsXmlException - if something goes wrong

unmarshal

public static CmsXmlPage unmarshal(CmsObject cms,
                   CmsFile file)
                            throws CmsXmlException

Factory method to unmarshal (read) a XML page instance from a OpenCms VFS file that contains XML data.

参数:

cms - the current cms object

file - the file with the XML data to unmarshal

返回:

a XML page instance unmarshalled from the provided file

抛出:

CmsXmlException - if something goes wrong

unmarshal

public static CmsXmlPage unmarshal(CmsObject cms,
                   CmsFile file,
                   boolean keepEncoding)
                            throws CmsXmlException

Factory method to unmarshal (read) a XML page instance from a OpenCms VFS file that contains XML data, using wither the encoding set in the XML file header, or the encoding set in the VFS file property.

If you are not sure about the implications of the encoding issues, use unmarshal(CmsObject, CmsFile) instead.

参数:

cms - the current OpenCms user context

file - the file with the XML data to unmarshal

keepEncoding - if true, the encoding spefified in the XML header is used, otherwise the encoding from the VFS file property is used

返回:

a XML page instance unmarshalled from the provided file

抛出:

CmsXmlException - if something goes wrong

unmarshal

public static CmsXmlPage unmarshal(CmsObject cms,
                   CmsResource resource,
                   javax.servlet.ServletRequest req)
                            throws CmsException

Factory method to unmarshal (read) a XML page instance from a resource, using the request attributes as cache.

参数:

cms - the current OpenCms user context

resource - the resource to unmarshal

req - the current request

返回:

the unmarshaled XML page, or null if the given resource was not of type CmsResourceTypeXmlPage

抛出:

CmsException - in something goes wrong

unmarshal

public static I_CmsXmlDocument unmarshal(CmsObject cms,
                         java.lang.String filename,
                         javax.servlet.ServletRequest req)
                                  throws CmsException

Factory method to unmarshal (read) a XML document instance from a filename in the VFS, using the request attributes as cache.

参数:

cms - the current OpenCms user context

filename - the filename of the resource to unmarshal

req - the current request

返回:

the unmarshaled XML document, or null if the given resource was not of type I_CmsXmlDocument

抛出:

CmsException - in something goes wrong

unmarshal

public static CmsXmlPage unmarshal(java.lang.String xmlData,
                   java.lang.String encoding,
                   org.xml.sax.EntityResolver resolver)
                            throws CmsXmlException

Factory method to unmarshal (read) a XML page instance from a String that contains XML data.

When unmarshalling, the encoding is read directly from the XML header. The given encoding is used only when marshalling the XML again later.

参数:

xmlData - the XML data in a String

encoding - the encoding to use when marshalling the XML page later

resolver - the XML entity resolver to use

返回:

a XML page instance unmarshalled from the String

抛出:

CmsXmlException - if something goes wrong