Package org.apache.fop.apps
Class FopFactoryBuilder
- java.lang.Object
-
- org.apache.fop.apps.FopFactoryBuilder
-
public final class FopFactoryBuilder extends java.lang.ObjectThis is the builder class forFopFactory. Setters can be chained to make building aFopFactoryobject more concise and intuitive e.g.FopFactoryBuilder fopFactoryBuilder = new FopFactoryBuilder(<URI>) .setURIResolver(<URIResolver>) .setPageHeight(<String>) .setPageWidth(<String>) .setStrictUserConfigValidation(<boolean>) ... etc ... FopFactory fopFactory = fopFactoryBuilder.build();
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classFopFactoryBuilder.FopFactoryConfigImpl
-
Constructor Summary
Constructors Constructor Description FopFactoryBuilder(java.net.URI defaultBaseURI)A builder class forFopFactorywhich can be used for setting configuration.FopFactoryBuilder(java.net.URI defaultBaseURI, org.apache.xmlgraphics.io.ResourceResolver resourceResolver)A builder class forFopFactorywhich can be used for setting configuration.FopFactoryBuilder(EnvironmentProfile enviro)A builder class forFopFactorywhich can be used for setting configuration.
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description FopFactorybuild()Builds an instance of the theFopFactory.FopFactoryConfigbuildConfig()Deprecated.Exposing theFopFactoryConfigis only to maintain backwards compatibilityFontManagergetFontManager()Returns theFontManagerused for managing the fonts within FOP.org.apache.xmlgraphics.image.loader.ImageManagergetImageManager()Return theImageManagerused for handling images through out FOP.FopFactoryBuilderignoreNamespace(java.lang.String namespaceURI)FOP will ignore the specified XML element namespace.FopFactoryBuilderignoreNamespaces(java.util.Collection<java.lang.String> namespaceURIs)FOP will ignore the colletion of XML element namespaces.FopFactoryBuildersetAccessibility(boolean enableAccessibility)Sets whether to include accessibility features in document creation.FopFactoryBuildersetBaseURI(java.net.URI baseURI)Sets the base URI, this will be used for resolving all URIs given to FOP.FopFactoryBuildersetBreakIndentInheritanceOnReferenceAreaBoundary(boolean value)Sets whether the indent inheritance should be broken when crossing reference area boundaries.FopFactoryBuildersetComplexScriptFeatures(boolean csf)FopFactoryBuildersetConfiguration(Configuration cfg)Sets the Avalon configuration if a FOP conf is used.FopFactoryBuildersetHyphenBaseResourceResolver(InternalResourceResolver hyphenationResourceResolver)FopFactoryBuildersetHyphPatNames(java.util.Map<java.lang.String,java.lang.String> hyphPatNames)FopFactoryBuildersetLayoutManagerMakerOverride(LayoutManagerMaker lmMaker)Sets theLayoutManagerMakerso that users can configure how FOP createsLayoutManagers.FopFactoryBuildersetPageHeight(java.lang.String pageHeight)Sets the page height of the paginated output.FopFactoryBuildersetPageWidth(java.lang.String pageWidth)Sets the page width of the paginated output.FopFactoryBuildersetPreferRenderer(boolean preferRenderer)Sets whether to chose aRendererin preference to anIFDocumentHandler.FopFactoryBuildersetSourceResolution(float dpi)Sets the resolution of resolution-dependent input.FopFactoryBuildersetStrictFOValidation(boolean validateStrictly)Sets whether to perform strict validation on the FO used.FopFactoryBuildersetStrictUserConfigValidation(boolean validateStrictly)Sets whether to perform strict alidation on the user-configuration.FopFactoryBuildersetTargetResolution(float dpi)Sets the resolution of resolution-dependent output.
-
-
-
Constructor Detail
-
FopFactoryBuilder
public FopFactoryBuilder(java.net.URI defaultBaseURI)
A builder class forFopFactorywhich can be used for setting configuration. This is a helper constructor that uses the default URI resolver implementation that FOP packages provide.- Parameters:
defaultBaseURI- the default base URI for resolving URIs against
-
FopFactoryBuilder
public FopFactoryBuilder(java.net.URI defaultBaseURI, org.apache.xmlgraphics.io.ResourceResolver resourceResolver)A builder class forFopFactorywhich can be used for setting configuration.- Parameters:
defaultBaseURI- the default base URI for resolving URIs againstresourceResolver- the URI resolver
-
FopFactoryBuilder
public FopFactoryBuilder(EnvironmentProfile enviro)
A builder class forFopFactorywhich can be used for setting configuration.- Parameters:
enviro- the profile of the FOP deployment environment
-
-
Method Detail
-
buildConfig
public FopFactoryConfig buildConfig()
Deprecated.Exposing theFopFactoryConfigis only to maintain backwards compatibilityReturns theFopFactoryConfigwhich is needed to get an instance ofFopFactory.- Returns:
- build the
FopFactoryConfig
-
build
public FopFactory build()
Builds an instance of the theFopFactory.- Returns:
- the FopFactory instance
-
getFontManager
public FontManager getFontManager()
Returns theFontManagerused for managing the fonts within FOP.- Returns:
- the font managing object
-
getImageManager
public org.apache.xmlgraphics.image.loader.ImageManager getImageManager()
Return theImageManagerused for handling images through out FOP.- Returns:
- the image manager
-
setAccessibility
public FopFactoryBuilder setAccessibility(boolean enableAccessibility)
Sets whether to include accessibility features in document creation.- Parameters:
enableAccessibility- true to set accessibility on- Returns:
this
-
setLayoutManagerMakerOverride
public FopFactoryBuilder setLayoutManagerMakerOverride(LayoutManagerMaker lmMaker)
Sets theLayoutManagerMakerso that users can configure how FOP createsLayoutManagers.- Parameters:
lmMaker- he layout manager maker- Returns:
this
-
setBaseURI
public FopFactoryBuilder setBaseURI(java.net.URI baseURI)
Sets the base URI, this will be used for resolving all URIs given to FOP.- Parameters:
baseURI- the base URI- Returns:
this
-
setHyphenBaseResourceResolver
public FopFactoryBuilder setHyphenBaseResourceResolver(InternalResourceResolver hyphenationResourceResolver)
-
setStrictFOValidation
public FopFactoryBuilder setStrictFOValidation(boolean validateStrictly)
Sets whether to perform strict validation on the FO used.- Parameters:
validateStrictly- true if the FO is to be strictly validated- Returns:
this
-
setStrictUserConfigValidation
public FopFactoryBuilder setStrictUserConfigValidation(boolean validateStrictly)
Sets whether to perform strict alidation on the user-configuration.- Parameters:
validateStrictly- true if the fop conf is to be strictly validated- Returns:
this
-
setBreakIndentInheritanceOnReferenceAreaBoundary
public FopFactoryBuilder setBreakIndentInheritanceOnReferenceAreaBoundary(boolean value)
Sets whether the indent inheritance should be broken when crossing reference area boundaries.- Parameters:
value- true to break inheritance when crossing reference area boundaries- Returns:
this
-
setSourceResolution
public FopFactoryBuilder setSourceResolution(float dpi)
Sets the resolution of resolution-dependent input.- Parameters:
dpi- the source resolution- Returns:
this
-
setTargetResolution
public FopFactoryBuilder setTargetResolution(float dpi)
Sets the resolution of resolution-dependent output.- Parameters:
dpi- the target resolution- Returns:
this
-
setPageHeight
public FopFactoryBuilder setPageHeight(java.lang.String pageHeight)
Sets the page height of the paginated output.- Parameters:
pageHeight- the page height- Returns:
this
-
setPageWidth
public FopFactoryBuilder setPageWidth(java.lang.String pageWidth)
Sets the page width of the paginated output.- Parameters:
pageWidth- the page width- Returns:
this
-
ignoreNamespace
public FopFactoryBuilder ignoreNamespace(java.lang.String namespaceURI)
FOP will ignore the specified XML element namespace.- Parameters:
namespaceURI- the namespace URI to ignore- Returns:
this
-
ignoreNamespaces
public FopFactoryBuilder ignoreNamespaces(java.util.Collection<java.lang.String> namespaceURIs)
FOP will ignore the colletion of XML element namespaces.- Parameters:
namespaceURIs- a collection of namespace URIs to ignore- Returns:
this
-
setConfiguration
public FopFactoryBuilder setConfiguration(Configuration cfg)
Sets the Avalon configuration if a FOP conf is used.- Parameters:
cfg- the fop conf configuration- Returns:
this
-
setPreferRenderer
public FopFactoryBuilder setPreferRenderer(boolean preferRenderer)
Sets whether to chose aRendererin preference to anIFDocumentHandler.- Parameters:
preferRenderer- true to preferRenderer- Returns:
this
-
setComplexScriptFeatures
public FopFactoryBuilder setComplexScriptFeatures(boolean csf)
-
setHyphPatNames
public FopFactoryBuilder setHyphPatNames(java.util.Map<java.lang.String,java.lang.String> hyphPatNames)
-
-