Home » xml-commons-external-1.4.01-src » javax » xml » rpc » encoding » [javadoc | source]

    1   /*
    2    * JBoss, Home of Professional Open Source.
    3    * Copyright 2006, Red Hat Middleware LLC, and individual contributors
    4    * as indicated by the @author tags. See the copyright.txt file in the
    5    * distribution for a full listing of individual contributors.
    6    *
    7    * This is free software; you can redistribute it and/or modify it
    8    * under the terms of the GNU Lesser General Public License as
    9    * published by the Free Software Foundation; either version 2.1 of
   10    * the License, or (at your option) any later version.
   11    *
   12    * This software is distributed in the hope that it will be useful,
   13    * but WITHOUT ANY WARRANTY; without even the implied warranty of
   14    * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
   15    * Lesser General Public License for more details.
   16    *
   17    * You should have received a copy of the GNU Lesser General Public
   18    * License along with this software; if not, write to the Free
   19    * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
   20    * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
   21    */
   22   package javax.xml.rpc.encoding;
   23   
   24   import java.io.Serializable;
   25   import java.util.Iterator;
   26   
   27   /**
   28    * This is a factory of the serializers. A SerializerFactory is registered
   29    * with a TypeMapping object as part of the TypeMappingRegistry.
   30    * 
   31    * @see Serializer
   32    * @see TypeMapping 
   33    * @see TypeMappingRegistry
   34    * 
   35    * @author Scott.Stark@jboss.org
   36    */
   37   public interface SerializerFactory extends Serializable
   38   {
   39      /** Returns a Serializer for the specified XML processing mechanism type.
   40       *
   41       * @param mechanismType XML processing mechanism type [TBD: definition of valid constants]
   42       * @return A Serializer
   43       * @throws javax.xml.rpc.JAXRPCException If SerializerFactory does not support the specified XML processing mechanism
   44       * @throws IllegalArgumentException If an invalid mechanism type is specified.
   45       */
   46      public Serializer getSerializerAs(String mechanismType);
   47   
   48      /** Returns a list of all XML processing mechanism types supported by this SerializerFactory.
   49       * @return List of unique identifiers for the supported XML processing mechanism types
   50       */
   51      public Iterator getSupportedMechanismTypes();
   52   }

Home » xml-commons-external-1.4.01-src » javax » xml » rpc » encoding » [javadoc | source]