/* * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright ownership. * The ASF licenses this file to You under the Apache License, Version 2.0 * (the "License"); you may not use this file except in compliance with * the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ /* $Id$ */ package org.apache.fop.apps; import java.net.URI; import org.apache.xmlgraphics.image.loader.impl.AbstractImageSessionContext.FallbackResolver; import org.apache.xmlgraphics.image.loader.impl.AbstractImageSessionContext.RestrictedFallbackResolver; import org.apache.xmlgraphics.image.loader.impl.AbstractImageSessionContext.UnrestrictedFallbackResolver; import org.apache.xmlgraphics.io.ResourceResolver; import org.apache.fop.apps.io.InternalResourceResolver; import org.apache.fop.apps.io.ResourceResolverFactory; import org.apache.fop.fonts.FontCacheManager; import org.apache.fop.fonts.FontCacheManagerFactory; import org.apache.fop.fonts.FontDetector; import org.apache.fop.fonts.FontDetectorFactory; import org.apache.fop.fonts.FontManager; /** * Creates an {@link EnvironmentProfile} that sets the environment in which a FOP instance is run. */ public final class EnvironmentalProfileFactory { private EnvironmentalProfileFactory() { }; /** * Creates the default environment that FOP is invoked in. This default profile has no * operational restrictions for FOP. * * @param defaultBaseUri the default base URI for resolving resource URIs * @param resourceResolver the resource resolver * @return the environment profile */ public static EnvironmentProfile createDefault(URI defaultBaseUri, ResourceResolver resourceResolver) { return new Profile(defaultBaseUri, resourceResolver, createFontManager(defaultBaseUri, resourceResolver, FontDetectorFactory.createDefault(), FontCacheManagerFactory.createDefault()), new UnrestrictedFallbackResolver()); } /** * Creates an IO-restricted environment for FOP by disabling some of the environment-specific * functionality within FOP. * * @param defaultBaseUri the default base URI for resolving resource URIs * @param resourceResolver the resource resolver * @return the environment profile */ public static EnvironmentProfile createRestrictedIO(URI defaultBaseUri, ResourceResolver resourceResolver) { return new Profile(defaultBaseUri, resourceResolver, createFontManager(defaultBaseUri, resourceResolver, FontDetectorFactory.createDisabled(), FontCacheManagerFactory.createDisabled()), new RestrictedFallbackResolver()); } private static final class Profile implements EnvironmentProfile { private final ResourceResolver resourceResolver; private final FontManager fontManager; private final URI defaultBaseURI; private final FallbackResolver fallbackResolver; private Profile(URI defaultBaseURI, ResourceResolver resourceResolver, FontManager fontManager, FallbackResolver fallbackResolver) { if (defaultBaseURI == null) { throw new IllegalArgumentException("Default base URI must not be null"); } if (resourceResolver == null) { throw new IllegalArgumentException("ResourceResolver must not be null"); } if (fontManager == null) { throw new IllegalArgumentException("The FontManager must not be null"); } this.defaultBaseURI = defaultBaseURI; this.resourceResolver = resourceResolver; this.fontManager = fontManager; this.fallbackResolver = fallbackResolver; } public ResourceResolver getResourceResolver() { return resourceResolver; } public FontManager getFontManager() { return fontManager; } public URI getDefaultBaseURI() { return defaultBaseURI; } public FallbackResolver getFallbackResolver() { return fallbackResolver; } } private static FontManager createFontManager(URI defaultBaseUri, ResourceResolver resourceResolver, FontDetector fontDetector, FontCacheManager fontCacheManager) { InternalResourceResolver internalResolver = ResourceResolverFactory.createInternalResourceResolver( defaultBaseUri, resourceResolver); return new FontManager(internalResolver, fontDetector, fontCacheManager); } }