001 /* 002 * Licensed to the Apache Software Foundation (ASF) under one 003 * or more contributor license agreements. See the NOTICE file 004 * distributed with this work for additional information 005 * regarding copyright ownership. The ASF licenses this file 006 * to you under the Apache License, Version 2.0 (the 007 * "License"); you may not use this file except in compliance 008 * with the License. You may obtain a copy of the License at 009 * 010 * http://www.apache.org/licenses/LICENSE-2.0 011 * 012 * Unless required by applicable law or agreed to in writing, 013 * software distributed under the License is distributed on an 014 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 015 * KIND, either express or implied. See the License for the 016 * specific language governing permissions and limitations 017 * under the License. 018 */ 019 020 package javax.xml.rpc.encoding; 021 022 import java.util.Iterator; 023 024 /** 025 * The javax.xml.rpc.encoding.SerializerFactory is a factory of 026 * the serializers. A SerializerFactory is registered with a 027 * TypeMapping object as part of the TypeMappingRegistry. 028 * 029 * @version $Rev: 467553 $ $Date: 2006-10-25 00:01:51 -0400 (Wed, 25 Oct 2006) $ 030 */ 031 public interface SerializerFactory extends java.io.Serializable { 032 033 /** 034 * Returns a Serializer for the specified XML processing mechanism type. 035 * 036 * @param mechanismType - XML processing mechanism type [TBD: definition 037 * of valid constants] 038 * 039 * @return a <code>Serializer</code> for the specified XML processing 040 * mechanism type 041 * 042 * @throws javax.xml.rpc.JAXRPCException 043 * if <code>SerializerFactory</code> does not support the 044 * specified XML processing mechanism 045 * @throws java.lang.IllegalArgumentException 046 * if an invalid mechanism type is specified 047 */ 048 public Serializer getSerializerAs(String mechanismType); 049 050 /** 051 * Returns an Iterator over all XML processing mechanism types supported by 052 * this <code>SerializerFactory</code>. 053 * 054 * @return an Iterator over the mechanism types (<Code>String</code>s?) 055 */ 056 public Iterator getSupportedMechanismTypes(); 057 } 058