View Javadoc
1   /*
2    * Copyright 2012 The Netty Project
3    *
4    * The Netty Project licenses this file to you under the Apache License,
5    * version 2.0 (the "License"); you may not use this file except in compliance
6    * with the License. You may obtain a copy of the License at:
7    *
8    * https://www.apache.org/licenses/LICENSE-2.0
9    *
10   * Unless required by applicable law or agreed to in writing, software
11   * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
12   * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
13   * License for the specific language governing permissions and limitations
14   * under the License.
15   */
16  
17  package io.netty.handler.codec.sctp;
18  
19  import io.netty.buffer.ByteBuf;
20  import io.netty.channel.ChannelHandlerContext;
21  import io.netty.channel.sctp.SctpMessage;
22  import io.netty.handler.codec.CodecException;
23  import io.netty.handler.codec.MessageToMessageDecoder;
24  
25  import java.util.List;
26  
27  /**
28   * A ChannelHandler which receives {@link SctpMessage}s which belong to a application protocol form a specific
29   * SCTP Stream  and decode it as {@link ByteBuf}.
30   */
31  public class SctpInboundByteStreamHandler extends MessageToMessageDecoder<SctpMessage> {
32      private final int protocolIdentifier;
33      private final int streamIdentifier;
34  
35      /**
36       * @param streamIdentifier   accepted stream number, this should be >=0 or <= max stream number of the association.
37       * @param protocolIdentifier supported application protocol.
38       */
39      public SctpInboundByteStreamHandler(int protocolIdentifier, int streamIdentifier) {
40          super(SctpMessage.class);
41          this.protocolIdentifier = protocolIdentifier;
42          this.streamIdentifier = streamIdentifier;
43      }
44  
45      @Override
46      public final boolean acceptInboundMessage(Object msg) throws Exception {
47          if (super.acceptInboundMessage(msg)) {
48              return acceptInboundMessage((SctpMessage) msg);
49          }
50          return false;
51      }
52  
53      protected boolean acceptInboundMessage(SctpMessage msg) {
54          return msg.protocolIdentifier() == protocolIdentifier && msg.streamIdentifier() == streamIdentifier;
55      }
56  
57      @Override
58      protected void decode(ChannelHandlerContext ctx, SctpMessage msg, List<Object> out) throws Exception {
59          if (!msg.isComplete()) {
60              throw new CodecException(String.format("Received SctpMessage is not complete, please add %s in the " +
61                      "pipeline before this handler", SctpMessageCompletionHandler.class.getSimpleName()));
62          }
63          out.add(msg.content().retain());
64      }
65  }