org.opencms.util

类 CmsHtmlConverter

java.lang.Object

org.opencms.util.CmsHtmlConverter

public class CmsHtmlConverter
extends java.lang.Object

HTML cleaner and pretty printer.

Used to clean up HTML code (e.g. remove word tags) and optionally create XHTML from HTML.

从以下版本开始:

6.0.0

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	PARAM_DISABLED Parameter value for disabled mode.
static java.lang.String	PARAM_ENABLED Parameter value for enabled mode.
static java.lang.String	PARAM_REPLACE_PARAGRAPHS Parameter value for replace paragraph mode.
static java.lang.String	PARAM_WORD Parameter value for WORD mode.
static java.lang.String	PARAM_XHTML Parameter value for XHTML mode.
static char	SEPARATOR_MODES The separator used for the configured modes String.

构造器概要

构造器

构造器和说明
CmsHtmlConverter() Constructor, creates a new CmsHtmlConverter.
CmsHtmlConverter(java.lang.String encoding, java.lang.String mode) Constructor, creates a new CmsHtmlConverter.

方法概要

方法

限定符和类型	方法和说明
byte[]	convertToByte(byte[] htmlInput) Converts the given HTML code according to the settings of this converter.
byte[]	convertToByte(java.lang.String htmlInput) Converts the given HTML code according to the settings of this converter.
byte[]	convertToByteSilent(byte[] htmlInput) Converts the given HTML code according to the settings of this converter.
byte[]	convertToByteSilent(java.lang.String htmlInput) Converts the given HTML code according to the settings of this converter.
java.lang.String	convertToString(byte[] htmlInput) Converts the given HTML code according to the settings of this converter.
java.lang.String	convertToString(java.lang.String htmlInput) Converts the given HTML code according to the settings of the converter.
java.lang.String	convertToStringSilent(byte[] htmlInput) Converts the given HTML code according to the settings of this converter.
java.lang.String	convertToStringSilent(java.lang.String htmlInput) Converts the given HTML code according to the settings of this converter.
static java.lang.String	getConversionSettings(CmsObject cms, CmsResource resource) Reads the content conversion property of a given resource and returns its value.
java.lang.String	getEncoding() Returns the encoding used for the HTML code conversion.
java.lang.String	getMode() Returns the conversion mode to use.
static boolean	isConversionEnabled(java.lang.String conversionMode) Tests if the content conversion is enabled.

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

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

字段详细资料

PARAM_DISABLED

public static final java.lang.String PARAM_DISABLED

Parameter value for disabled mode.

PARAM_ENABLED

public static final java.lang.String PARAM_ENABLED

Parameter value for enabled mode.

PARAM_REPLACE_PARAGRAPHS

public static final java.lang.String PARAM_REPLACE_PARAGRAPHS

Parameter value for replace paragraph mode.

另请参阅:

常量字段值

PARAM_WORD

public static final java.lang.String PARAM_WORD

Parameter value for WORD mode.

另请参阅:

常量字段值

PARAM_XHTML

public static final java.lang.String PARAM_XHTML

Parameter value for XHTML mode.

另请参阅:

常量字段值

SEPARATOR_MODES

public static final char SEPARATOR_MODES

The separator used for the configured modes String.

另请参阅:

常量字段值

构造器详细资料

CmsHtmlConverter

public CmsHtmlConverter()

Constructor, creates a new CmsHtmlConverter.

The encoding used by default is CmsEncoder.ENCODING_UTF_8.

CmsHtmlConverter

public CmsHtmlConverter(java.lang.String encoding,
                java.lang.String mode)

Constructor, creates a new CmsHtmlConverter.

Possible values for the default conversion mode are:

• PARAM_DISABLED: The conversion is disabled.
• PARAM_ENABLED: Conversion is enabled without transformation, so HTML is pretty printed only.
• PARAM_XHTML: Conversion from HTML to XHTML is enabled.
• PARAM_WORD: Cleanup of word like HTML tags is enabled.
• Other values can be used by the implementing converter class.

Values can be combined with the ; separator, so it is e.g. possible to convert to XHTML and clean from word at the same time.

参数:

encoding - the encoding used for the HTML code conversion

mode - the conversion mode to use

方法详细资料

getConversionSettings

public static java.lang.String getConversionSettings(CmsObject cms,
                                     CmsResource resource)

Reads the content conversion property of a given resource and returns its value.

A default value (disabled) is returned if the property could not be read.

参数:

cms - the CmsObject

resource - the resource in the VFS

返回:

the content conversion property value

isConversionEnabled

public static boolean isConversionEnabled(java.lang.String conversionMode)

Tests if the content conversion is enabled.

参数:

conversionMode - the content conversion mode string

返回:

true or false

convertToByte

public byte[] convertToByte(byte[] htmlInput)
                     throws java.io.UnsupportedEncodingException

Converts the given HTML code according to the settings of this converter.

参数:

htmlInput - HTML input stored in an array of bytes

返回:

array of bytes containing the converted HTML

抛出:

java.io.UnsupportedEncodingException - if the encoding set for the conversion is not supported

convertToByte

public byte[] convertToByte(java.lang.String htmlInput)
                     throws java.io.UnsupportedEncodingException

Converts the given HTML code according to the settings of this converter.

参数:

htmlInput - HTML input stored in a string

返回:

array of bytes containing the converted HTML

抛出:

java.io.UnsupportedEncodingException - if the encoding set for the conversion is not supported

convertToByteSilent

public byte[] convertToByteSilent(byte[] htmlInput)

Converts the given HTML code according to the settings of this converter.

If an any error occurs during the conversion process, the original input is returned unmodified.

参数:

htmlInput - HTML input stored in an array of bytes

返回:

array of bytes containing the converted HTML

convertToByteSilent

public byte[] convertToByteSilent(java.lang.String htmlInput)

Converts the given HTML code according to the settings of this converter.

If an any error occurs during the conversion process, the original input is returned unmodified.

参数:

htmlInput - HTML input stored in a string

返回:

array of bytes containing the converted HTML

convertToString

public java.lang.String convertToString(byte[] htmlInput)
                                 throws java.io.UnsupportedEncodingException

Converts the given HTML code according to the settings of this converter.

参数:

htmlInput - HTML input stored in an array of bytes

返回:

string containing the converted HTML

抛出:

java.io.UnsupportedEncodingException - if the encoding set for the conversion is not supported

convertToString

public java.lang.String convertToString(java.lang.String htmlInput)
                                 throws java.io.UnsupportedEncodingException

Converts the given HTML code according to the settings of the converter.

参数:

htmlInput - HTML input stored in a string

返回:

string containing the converted HTML

抛出:

java.io.UnsupportedEncodingException - if the encoding set for the conversion is not supported

convertToStringSilent

public java.lang.String convertToStringSilent(byte[] htmlInput)

Converts the given HTML code according to the settings of this converter.

If an any error occurs during the conversion process, the original input is returned unmodified.

参数:

htmlInput - HTML input stored in an array of bytes

返回:

string containing the converted HTML

convertToStringSilent

public java.lang.String convertToStringSilent(java.lang.String htmlInput)

Converts the given HTML code according to the settings of this converter.

If an any error occurs during the conversion process, the original input is returned unmodified.

参数:

htmlInput - HTML input stored in string

返回:

string containing the converted HTML

getEncoding

public java.lang.String getEncoding()

Returns the encoding used for the HTML code conversion.

返回:

the encoding used for the HTML code conversion

getMode

public java.lang.String getMode()

Returns the conversion mode to use.

返回:

the conversion mode to use