@ProviderType
public interface ContentTypeConverter
Provides means to convert texts of a certain content type to another content type.
The entire conversion process uses HTML as base format. This means that you might need two conversion steps to convert a text from format A to format B: First, you convert format A to HTML. Then the HTML to format B.
For example, to convert a plain text to Markdown, use the following snippet:
String html = converter.convertToHTML(plainText, "text/plain");
String markdown = converter.convertToType(html, "text/x-markdown");
Note that depending on the quality of the ContentTypeAdapter
implementations
(or the target text format) you might loose some (or all) formatting.
Additional ContentTypeAdapter
s can be provided by external bundles. To
override default adapters, use the OSGi service ranking. The default adapters have a
service ranking of 0.
Modifier and Type | Method and Description |
---|---|
String |
convertToHTML(String text,
String type)
Converts a given text of the specified format to its HTML equivalent.
|
String |
convertToType(String html,
String type)
Converts the given HTML fragment to an equivalent text of the specified
target format.
|
String convertToHTML(String text, String type) throws ContentFragmentException
text
- The texttype
- The MIME type of the text's formatContentFragmentException
- if the conversion failedString convertToType(String html, String type) throws ContentFragmentException
html
- The original HTML fragmenttype
- The MIME type of the target formatContentFragmentException
- if the conversion failedCopyright © 2010 - 2020 Adobe. All Rights Reserved