001 /* 002 * Copyright 2001-2004 The Apache Software Foundation. 003 * 004 * Licensed under the Apache License, Version 2.0 (the "License"); 005 * you may not use this file except in compliance with the License. 006 * You may obtain a copy of the License at 007 * 008 * http://www.apache.org/licenses/LICENSE-2.0 009 * 010 * Unless required by applicable law or agreed to in writing, software 011 * distributed under the License is distributed on an "AS IS" BASIS, 012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 013 * See the License for the specific language governing permissions and 014 * limitations under the License. 015 */ 016 package javax.xml.rpc.encoding; 017 018 /** 019 * The javax.xml.rpc.encoding.DeserializerFactory is a factory of 020 * deserializers. A DeserializerFactory is registered with a 021 * TypeMapping instance as part of the TypeMappingRegistry. 022 * 023 * @version 1.0 024 */ 025 public interface DeserializerFactory extends java.io.Serializable { 026 027 /** 028 * Returns a Deserializer for the specified XML processing mechanism type. 029 * 030 * @param mechanismType XML processing mechanism type [TBD: definition of 031 * valid constants] 032 * 033 * @return a Deserializer for the specified XML processing mechanism type 034 * 035 * @throws javax.xml.rpc.JAXRPCException if DeserializerFactory does not 036 * support the specified XML processing mechanism 037 */ 038 public Deserializer getDeserializerAs(String mechanismType); 039 040 /** 041 * Returns an <code>Iterator</code> over the list of all XML processing 042 * mechanism types supported by this <code>DeserializerFactory</code>. 043 * 044 * @return an <code>Iterator</code> over the unique identifiers for the 045 * supported XML processing mechanism types (as 046 * <code>String</code>s?) 047 */ 048 public java.util.Iterator getSupportedMechanismTypes(); 049 } 050