View Javadoc

1   /*
2    *   @(#) $Id: ProtocolCodecFactory.java 210062 2005-07-11 03:52:38Z trustin $
3    *
4    *   Copyright 2004 The Apache Software Foundation
5    *
6    *   Licensed under the Apache License, Version 2.0 (the "License");
7    *   you may not use this file except in compliance with the License.
8    *   You may obtain a copy of the License at
9    *
10   *       http://www.apache.org/licenses/LICENSE-2.0
11   *
12   *   Unless required by applicable law or agreed to in writing, software
13   *   distributed under the License is distributed on an "AS IS" BASIS,
14   *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15   *   See the License for the specific language governing permissions and
16   *   limitations under the License.
17   *
18   */
19  package org.apache.mina.protocol;
20  
21  /***
22   * Provides {@link ProtocolEncoder} and {@link ProtocolDecoder} which translates
23   * binary or protocol specific data into message object and vice versa.
24   * <p>
25   * Please refer to
26   * <a href="../../../../../xref-examples/org/apache/mina/examples/reverser/ReverseProtocolProvider.html"><code>ReverserProtocolProvider</code></a>
27   * example.
28   *  
29   * @author Trustin Lee (trustin@apache.org)
30   * @version $Rev: 210062 $, $Date: 2005-07-11 12:52:38 +0900 $
31   */
32  public interface ProtocolCodecFactory
33  {
34      /***
35       * Creates a new instance of {@link ProtocolEncoder} which encodes message
36       * objects into binary or protocol-specific data.
37       */
38      ProtocolEncoder newEncoder();
39  
40      /***
41       * Creates a new instance of {@link ProtocolDecoder} which decodes binary or
42       * protocol-specific data into message objects.
43       */
44      ProtocolDecoder newDecoder();
45  }