01: /*
02: * Licensed to the Apache Software Foundation (ASF) under one
03: * or more contributor license agreements. See the NOTICE file
04: * distributed with this work for additional information
05: * regarding copyright ownership. The ASF licenses this file
06: * to you under the Apache License, Version 2.0 (the
07: * "License"); you may not use this file except in compliance
08: * with the License. You may obtain a copy of the License at
09: *
10: * http://www.apache.org/licenses/LICENSE-2.0
11: *
12: * Unless required by applicable law or agreed to in writing,
13: * software distributed under the License is distributed on an
14: * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15: * KIND, either express or implied. See the License for the
16: * specific language governing permissions and limitations
17: * under the License.
18: *
19: */
20: package org.apache.mina.filter.codec;
21:
22: import org.apache.mina.common.IoSession;
23:
24: /**
25: * Provides {@link ProtocolEncoder} and {@link ProtocolDecoder} which translates
26: * binary or protocol specific data into message object and vice versa.
27: * <p>
28: * Please refer to
29: * <a href="../../../../../xref-examples/org/apache/mina/examples/reverser/ReverseProtocolProvider.html"><code>ReverserProtocolProvider</code></a>
30: * example.
31: *
32: * @author The Apache MINA Project (dev@mina.apache.org)
33: * @version $Rev: 597820 $, $Date: 2007-11-23 23:48:54 -0700 (Fri, 23 Nov 2007) $
34: */
35: public interface ProtocolCodecFactory {
36: /**
37: * Returns a new (or reusable) instance of {@link ProtocolEncoder} which
38: * encodes message objects into binary or protocol-specific data.
39: */
40: ProtocolEncoder getEncoder(IoSession session) throws Exception;
41:
42: /**
43: * Returns a new (or reusable) instance of {@link ProtocolDecoder} which
44: * decodes binary or protocol-specific data into message objects.
45: */
46: ProtocolDecoder getDecoder(IoSession session) throws Exception;
47: }
|