Java的UIMA注解类 uimaFIT.7z

/* Copyright 2009 Ubiquitous Knowledge Processing (UKP) Lab Technische Universitaet Darmstadt All rights reserved. Licensed 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. */ package org.uimafit.factory; import static org.apache.uima.UIMAFramework.getResourceSpecifierFactory; import static org.uimafit.factory.ConfigurationParameterFactory.canParameterBeSet; import static org.uimafit.factory.ConfigurationParameterFactory.createConfigurationData; import java.io.File; import java.net.MalformedURLException; import java.net.URL; import java.util.ArrayList; import java.util.Collections; import java.util.HashMap; import java.util.List; import java.util.Map; import java.util.Map.Entry; import java.util.concurrent.atomic.AtomicLong; import org.apache.commons.lang.ArrayUtils; import org.apache.uima.analysis_engine.AnalysisEngineDescription; import org.apache.uima.collection.CollectionReaderDescription; import org.apache.uima.resource.ConfigurableDataResourceSpecifier; import org.apache.uima.resource.CustomResourceSpecifier; import org.apache.uima.resource.DataResource; import org.apache.uima.resource.ExternalResourceDependency; import org.apache.uima.resource.ExternalResourceDescription; import org.apache.uima.resource.FileResourceSpecifier; import org.apache.uima.resource.Parameter; import org.apache.uima.resource.ParameterizedDataResource; import org.apache.uima.resource.Resource; import org.apache.uima.resource.ResourceCreationSpecifier; import org.apache.uima.resource.ResourceManager; import org.apache.uima.resource.ResourceSpecifier; import org.apache.uima.resource.SharedResourceObject; import org.apache.uima.resource.impl.ConfigurableDataResourceSpecifier_impl; import org.apache.uima.resource.impl.ExternalResourceDependency_impl; import org.apache.uima.resource.impl.ExternalResourceDescription_impl; import org.apache.uima.resource.impl.FileResourceSpecifier_impl; import org.apache.uima.resource.impl.Parameter_impl; import org.apache.uima.resource.metadata.ExternalResourceBinding; import org.apache.uima.resource.metadata.ResourceManagerConfiguration; import org.apache.uima.resource.metadata.impl.ExternalResourceBinding_impl; import org.apache.uima.resource.metadata.impl.ResourceManagerConfiguration_impl; import org.apache.uima.resource.metadata.impl.ResourceMetaData_impl; import org.apache.uima.util.InvalidXMLException; import org.uimafit.descriptor.ExternalResource; import org.uimafit.factory.ConfigurationParameterFactory.ConfigurationData; import org.uimafit.util.ExtendedExternalResourceDescription_impl; /** * Helper methods for external resources. * * @author Richard Eckart de Castilho */ public final class ExternalResourceFactory { public static final String PARAM_RESOURCE_NAME = "__UIMAFIT_RESOURCE_NAME__"; /** * Used to separate resource name from key for nested resource. */ public static final String PREFIX_SEPARATOR = "##"; /** * Counter used to create unique resource names. */ private final static AtomicLong DISAMBIGUATOR = new AtomicLong(); private ExternalResourceFactory() { // This class is not meant to be instantiated } /** * Create an external resource description for a custom resource. This is intended to * be used together with .... * * @param aInterface * the interface the resource should implement. * @param aParams * parameters passed to the resource when it is created. * @return the description. * @see CustomResourceSpecifier */ public static ExternalResourceDescription createExternalResourceDescription( Class<? extends Resource> aInterface, Object... aParams) { return createExternalResourceDescription(uniqueResourceKey(aInterface.getName()), aInterface, aParams); } /** * Create an external resource description for a custom resource. * * @param aName * the name of the resource (the key). * @param aInterface * the interface the resource should implement. * @param aParams * parameters passed to the resource when it is created. * @return the description. * @see CustomResourceSpecifier */ public static ExternalResourceDescription createExternalResourceDescription(final String aName, Class<? extends Resource> aInterface, Object... aParams) { ConfigurationParameterFactory.ensureParametersComeInPairs(aParams); // Extract ExternalResourceDescriptions from configurationData List<ExternalResourceBinding> bindings = new ArrayList<ExternalResourceBinding>(); List<ExternalResourceDescription> descs = new ArrayList<ExternalResourceDescription>(); for (Entry<String, ExternalResourceDescription> res : extractExternalResourceParameters( aParams).entrySet()) { bindings.add(createExternalResourceBinding(res.getKey(), res.getValue())); descs.add(res.getValue()); } List<Parameter> params = new ArrayList<Parameter>(); if (aParams != null) { for (int i = 0; i < aParams.length / 2; i++) { if (aParams[i * 2 + 1] instanceof ExternalResourceDescription) { continue; } Parameter param = new Parameter_impl(); param.setName((String) aParams[i * 2]); param.setValue((String) aParams[i * 2 + 1]); params.add(param); } } CustomResourceSpecifier spec = getResourceSpecifierFactory().createCustomResourceSpecifier(); spec.setResourceClassName(aInterface.getName()); spec.setParameters(params.toArray(new Parameter[params.size()])); ExtendedExternalResourceDescription_impl extRes = new ExtendedExternalResourceDescription_impl(); extRes.setName(aName); extRes.setResourceSpecifier(spec); extRes.setExternalResourceBindings(bindings); extRes.setExternalResources(descs); return extRes; } /** * Create an external resource description for a {@link SharedResourceObject}. * * @param aInterface * the interface the resource should implement. * @param aUrl * the URL from which the resource is initialized. * @param aParams * parameters passed to the resource when it is created. * @return the description. * @see ConfigurableDataResourceSpecifier * @see SharedResourceObject */ public static ExternalResourceDescription createExternalResourceDescription( Class<? extends SharedResourceObject> aInterface, String aUrl, Object... aParams) { return createExternalResourceDescription(uniqueResourceKey(aInterface.getName()), aInterface, aUrl, aParams); } /** * Create an external resource description for a {@link SharedResourceObject}. * * @param aInterface * the interface the resource should implement. * @param aUrl * the URL from which the resource is initialized. * @param aParams * parameters passed to the resource when it is created. * @return the description. * @see ConfigurableDataResourceSpecifier * @see SharedResourceObject */ public static ExternalResourceDescription createExternalResourceDescription( Class<? extends SharedResourceObject> aInterface, URL aUrl, Object... aParams) { return createExternalResourceDescription(uniqueResourceKey(aInterface.getName()), aInterface, aUrl.toString(), aParams); } /** * Create an external resource description for a {@link SharedResourceObject}. * * @param aInterface * the interface the resource should implement. * @param aFile * the file from which the resource is initialized. * @param aParams * parameters passed to the resource when it is created. * @return the