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 */
020package org.apache.mina.filter.codec.demux;
021
022import org.apache.mina.core.session.IoSession;
023import org.apache.mina.filter.codec.ProtocolCodecFactory;
024import org.apache.mina.filter.codec.ProtocolDecoder;
025import org.apache.mina.filter.codec.ProtocolEncoder;
026
027/**
028 * A convenience {@link ProtocolCodecFactory} that provides {@link DemuxingProtocolEncoder}
029 * and {@link DemuxingProtocolDecoder} as a pair.
030 * <p>
031 * {@link DemuxingProtocolEncoder} and {@link DemuxingProtocolDecoder} demultiplex
032 * incoming messages and buffers to appropriate {@link MessageEncoder}s and 
033 * {@link MessageDecoder}s.
034 *
035 * @author <a href="http://mina.apache.org">Apache MINA Project</a>
036 */
037public class DemuxingProtocolCodecFactory implements ProtocolCodecFactory {
038
039    private final DemuxingProtocolEncoder encoder = new DemuxingProtocolEncoder();
040
041    private final DemuxingProtocolDecoder decoder = new DemuxingProtocolDecoder();
042
043    public DemuxingProtocolCodecFactory() {
044        // Do nothing
045    }
046
047    /**
048     * {@inheritDoc}
049     */
050    public ProtocolEncoder getEncoder(IoSession session) throws Exception {
051        return encoder;
052    }
053
054    /**
055     * {@inheritDoc}
056     */
057    public ProtocolDecoder getDecoder(IoSession session) throws Exception {
058        return decoder;
059    }
060
061    public void addMessageEncoder(Class<?> messageType, Class<? extends MessageEncoder> encoderClass) {
062        this.encoder.addMessageEncoder(messageType, encoderClass);
063    }
064
065    public <T> void addMessageEncoder(Class<T> messageType, MessageEncoder<? super T> encoder) {
066        this.encoder.addMessageEncoder(messageType, encoder);
067    }
068
069    public <T> void addMessageEncoder(Class<T> messageType, MessageEncoderFactory<? super T> factory) {
070        this.encoder.addMessageEncoder(messageType, factory);
071    }
072
073    public void addMessageEncoder(Iterable<Class<?>> messageTypes, Class<? extends MessageEncoder> encoderClass) {
074        for (Class<?> messageType : messageTypes) {
075            addMessageEncoder(messageType, encoderClass);
076        }
077    }
078
079    public <T> void addMessageEncoder(Iterable<Class<? extends T>> messageTypes, MessageEncoder<? super T> encoder) {
080        for (Class<? extends T> messageType : messageTypes) {
081            addMessageEncoder(messageType, encoder);
082        }
083    }
084
085    public <T> void addMessageEncoder(Iterable<Class<? extends T>> messageTypes,
086            MessageEncoderFactory<? super T> factory) {
087        for (Class<? extends T> messageType : messageTypes) {
088            addMessageEncoder(messageType, factory);
089        }
090    }
091
092    public void addMessageDecoder(Class<? extends MessageDecoder> decoderClass) {
093        this.decoder.addMessageDecoder(decoderClass);
094    }
095
096    public void addMessageDecoder(MessageDecoder decoder) {
097        this.decoder.addMessageDecoder(decoder);
098    }
099
100    public void addMessageDecoder(MessageDecoderFactory factory) {
101        this.decoder.addMessageDecoder(factory);
102    }
103}