org.apache.mina.filter.codec.prefixedstring.PrefixedStringEncoder Maven / Gradle / Ivy
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*
*/
package org.apache.mina.filter.codec.prefixedstring;
import org.apache.mina.core.buffer.IoBuffer;
import org.apache.mina.core.session.IoSession;
import org.apache.mina.filter.codec.ProtocolEncoderAdapter;
import org.apache.mina.filter.codec.ProtocolEncoderOutput;
import org.apache.mina.filter.codec.ProtocolEncoder;
import java.nio.charset.Charset;
/**
* A {@link ProtocolEncoder} which encodes a string
* using a fixed-length length prefix.
*
* @author Apache MINA Project
*/
public class PrefixedStringEncoder extends ProtocolEncoderAdapter {
/** The default length for the prefix */
public static final int DEFAULT_PREFIX_LENGTH = 4;
/** The default maximum data length */
public static final int DEFAULT_MAX_DATA_LENGTH = 2048;
private final Charset charset;
private int prefixLength = DEFAULT_PREFIX_LENGTH;
private int maxDataLength = DEFAULT_MAX_DATA_LENGTH;
/**
* Creates a new PrefixedStringEncoder instance
*
* @param charset the {@link Charset} to use for encoding
* @param prefixLength the length of the prefix
* @param maxDataLength maximum number of bytes allowed for a single String
*/
public PrefixedStringEncoder(Charset charset, int prefixLength, int maxDataLength) {
this.charset = charset;
this.prefixLength = prefixLength;
this.maxDataLength = maxDataLength;
}
/**
* Creates a new PrefixedStringEncoder instance
*
* @param charset the {@link Charset} to use for encoding
* @param prefixLength the length of the prefix
*/
public PrefixedStringEncoder(Charset charset, int prefixLength) {
this(charset, prefixLength, DEFAULT_MAX_DATA_LENGTH);
}
/**
* Creates a new PrefixedStringEncoder instance
*
* @param charset the {@link Charset} to use for encoding
*/
public PrefixedStringEncoder(Charset charset) {
this(charset, DEFAULT_PREFIX_LENGTH);
}
/**
* Creates a new PrefixedStringEncoder instance
*/
public PrefixedStringEncoder() {
this(Charset.defaultCharset());
}
/**
* Sets the number of bytes used by the length prefix
*
* @param prefixLength the length of the length prefix (1, 2, or 4)
*/
public void setPrefixLength(int prefixLength) {
if (prefixLength != 1 && prefixLength != 2 && prefixLength != 4) {
throw new IllegalArgumentException("prefixLength: " + prefixLength);
}
this.prefixLength = prefixLength;
}
/**
* Gets the length of the length prefix (1, 2, or 4)
*
* @return length of the length prefix
*/
public int getPrefixLength() {
return prefixLength;
}
/**
* Sets the maximum number of bytes allowed for encoding a single String
* (including the prefix)
*
* The encoder will throw a {@link IllegalArgumentException} when more bytes
* are needed to encode a String value.
* The default value is {@link PrefixedStringEncoder#DEFAULT_MAX_DATA_LENGTH}.
*
*
* @param maxDataLength maximum number of bytes allowed for encoding a single String
*/
public void setMaxDataLength(int maxDataLength) {
this.maxDataLength = maxDataLength;
}
/**
* Gets the maximum number of bytes allowed for encoding a single String *
*
* @return maximum number of bytes allowed for encoding a single String (prefix included)
*/
public int getMaxDataLength() {
return maxDataLength;
}
/**
* {@inheritDoc}
*/
@Override
public void encode(IoSession session, Object message, ProtocolEncoderOutput out) throws Exception {
String value = (String) message;
IoBuffer buffer = IoBuffer.allocate(value.length()).setAutoExpand(true);
buffer.putPrefixedString(value, prefixLength, charset.newEncoder());
if (buffer.position() > maxDataLength) {
throw new IllegalArgumentException("Data length: " + buffer.position());
}
buffer.flip();
out.write(buffer);
}
}