org.jruby.util.encoding

Class CharsetTranscoder

java.lang.Object

org.jruby.util.encoding.Transcoder

org.jruby.util.encoding.CharsetTranscoder

public class CharsetTranscoder
extends Transcoder

Encapsulate all logic associated with using Java Charset transcoding facilities.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CharsetTranscoder.CodingActions
class	CharsetTranscoder.TranscoderEngine

Field Summary

Fields

Modifier and Type	Field and Description
private CharsetTranscoder.CodingActions	actions
private static java.util.Set<java.lang.String>	BAD_TRANSCODINGS_HACK
private RaiseException	lastError
private static int	MAX_ARRAY_SIZE
private CharsetTranscoder.TranscoderEngine	transcoder
static java.util.Set<java.nio.charset.Charset>	UNICODE_CHARSETS
static java.lang.String[]	XMLAttrCharacterTranslator
static java.lang.String[]	XMLTextCharacterTranslator

Fields inherited from class org.jruby.util.encoding.Transcoder

inEncoding, lastResult, outEncoding, runtime

Constructor Summary

Constructors

Constructor and Description
CharsetTranscoder(ThreadContext context, org.jcodings.Encoding outEncoding, org.jcodings.Encoding inEncoding)
CharsetTranscoder(ThreadContext context, org.jcodings.Encoding outEncoding, org.jcodings.Encoding inEncoding, CharsetTranscoder.CodingActions actions)
CharsetTranscoder(ThreadContext context, org.jcodings.Encoding outEncoding, org.jcodings.Encoding inEncoding, int flags, IRubyObject replace)

Method Summary

Modifier and Type	Method and Description
org.jruby.util.ByteList	convert(ThreadContext context, org.jruby.util.ByteList value, boolean is7BitASCII)
private void	createLastError()
private void	createTranscoder(org.jcodings.Encoding inEncoding, org.jcodings.Encoding outEncoding, CharsetTranscoder.CodingActions actions, boolean is7BitASCII)
RubyCoderResult	econvConvert(ThreadContext context, org.jruby.util.ByteList inBuffer, org.jruby.util.ByteList outBuffer)
org.jruby.util.ByteList	econvStrConvert(ThreadContext context, org.jruby.util.ByteList value, boolean finish)
org.jruby.util.ByteList	finish(org.jcodings.Encoding altEncoding)
CharsetTranscoder.CodingActions	getCodingErrorActions()
RaiseException	getLastError()
RubyCoderResult	getLastResult()
java.lang.String	getReplaceWith()
static CharsetTranscoder	open(ThreadContext context, byte[] sourceEncoding, byte[] destinationEncoding, int flags, IRubyObject replace)
RubyCoderResult	primitiveConvert(ThreadContext context, org.jruby.util.ByteList inBuffer, org.jruby.util.ByteList outBuffer, int outOffset, int outLimit, org.jcodings.Encoding inEncoding, boolean is7BitASCII, int flags)
static CharsetTranscoder.CodingActions	processCodingErrorActions(ThreadContext context, int flags, IRubyObject replace)
static CharsetTranscoder.CodingActions	processCodingErrorActions(ThreadContext context, IRubyObject opts)
private static java.lang.String	replaceStringFromActions(CharsetTranscoder.CodingActions actions, java.nio.charset.Charset outCharset)
static java.lang.String	stringFromCoderResult(java.nio.charset.CoderResult coderResult, int flags, boolean binaryToCharacter)
static org.jruby.util.ByteList	strTranscode(ThreadContext context, RubyString self, org.jcodings.Encoding fromEncoding, org.jcodings.Encoding toEncoding, IRubyObject opt)
static org.jruby.util.ByteList	strTranscode0(ThreadContext context, RubyString self, org.jcodings.Encoding senc, org.jcodings.Encoding denc, int ecflags, IRubyObject ecopts)
org.jruby.util.ByteList	transcode(ThreadContext context, org.jruby.util.ByteList value)
org.jruby.util.ByteList	transcode(ThreadContext context, org.jruby.util.ByteList value, boolean is7BitASCII)
RubyCoderResult	transcode(ThreadContext context, org.jruby.util.ByteList value, org.jruby.util.ByteList dest)
private RubyCoderResult	transcode(ThreadContext context, org.jruby.util.ByteList inBuffer, org.jruby.util.ByteList outBuffer, org.jcodings.Encoding inEncoding, boolean is7BitASCII, boolean finish)
static org.jruby.util.ByteList	transcode(ThreadContext context, org.jruby.util.ByteList value, org.jcodings.Encoding fromEncoding, org.jcodings.Encoding toEncoding, IRubyObject opts) This will try and transcode the supplied ByteList to the supplied toEncoding.
static org.jruby.util.ByteList	transcode(ThreadContext context, org.jruby.util.ByteList value, org.jcodings.Encoding fromEncoding, org.jcodings.Encoding toEncoding, IRubyObject opts, boolean is7BitASCII)
static java.nio.charset.Charset	transcodeCharsetFor(Ruby runtime, byte[] name, org.jcodings.Encoding encoding, boolean is7Bit)

Methods inherited from class org.jruby.util.encoding.Transcoder

open0, strConvEnc, strConvEncOpts

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

BAD_TRANSCODINGS_HACK

private static java.util.Set<java.lang.String> BAD_TRANSCODINGS_HACK

MAX_ARRAY_SIZE

private static final int MAX_ARRAY_SIZE

actions

private CharsetTranscoder.CodingActions actions

transcoder

private CharsetTranscoder.TranscoderEngine transcoder

lastError

private RaiseException lastError

XMLTextCharacterTranslator

public static final java.lang.String[] XMLTextCharacterTranslator

XMLAttrCharacterTranslator

public static final java.lang.String[] XMLAttrCharacterTranslator

UNICODE_CHARSETS

public static final java.util.Set<java.nio.charset.Charset> UNICODE_CHARSETS

Constructor Detail

CharsetTranscoder

public CharsetTranscoder(ThreadContext context,
                         org.jcodings.Encoding outEncoding,
                         org.jcodings.Encoding inEncoding)

CharsetTranscoder

public CharsetTranscoder(ThreadContext context,
                         org.jcodings.Encoding outEncoding,
                         org.jcodings.Encoding inEncoding,
                         int flags,
                         IRubyObject replace)

CharsetTranscoder

public CharsetTranscoder(ThreadContext context,
                         org.jcodings.Encoding outEncoding,
                         org.jcodings.Encoding inEncoding,
                         CharsetTranscoder.CodingActions actions)

Method Detail

open

public static CharsetTranscoder open(ThreadContext context,
                                     byte[] sourceEncoding,
                                     byte[] destinationEncoding,
                                     int flags,
                                     IRubyObject replace)

transcode

public static org.jruby.util.ByteList transcode(ThreadContext context,
                                                org.jruby.util.ByteList value,
                                                org.jcodings.Encoding fromEncoding,
                                                org.jcodings.Encoding toEncoding,
                                                IRubyObject opts)

This will try and transcode the supplied ByteList to the supplied toEncoding. It will use forceEncoding as its encoding if it is supplied; otherwise it will use the encoding it has tucked away in the bytelist. This will return a new copy of a ByteList in the request encoding or die trying (ConverterNotFound). c: rb_str_conv_enc_opts

transcode

public static org.jruby.util.ByteList transcode(ThreadContext context,
                                                org.jruby.util.ByteList value,
                                                org.jcodings.Encoding fromEncoding,
                                                org.jcodings.Encoding toEncoding,
                                                IRubyObject opts,
                                                boolean is7BitASCII)

strTranscode

public static org.jruby.util.ByteList strTranscode(ThreadContext context,
                                                   RubyString self,
                                                   org.jcodings.Encoding fromEncoding,
                                                   org.jcodings.Encoding toEncoding,
                                                   IRubyObject opt)

strTranscode0

public static org.jruby.util.ByteList strTranscode0(ThreadContext context,
                                                    RubyString self,
                                                    org.jcodings.Encoding senc,
                                                    org.jcodings.Encoding denc,
                                                    int ecflags,
                                                    IRubyObject ecopts)

transcode

public RubyCoderResult transcode(ThreadContext context,
                                 org.jruby.util.ByteList value,
                                 org.jruby.util.ByteList dest)

Specified by:

transcode in class Transcoder

econvConvert

public RubyCoderResult econvConvert(ThreadContext context,
                                    org.jruby.util.ByteList inBuffer,
                                    org.jruby.util.ByteList outBuffer)

Specified by:

econvConvert in class Transcoder

transcode

public org.jruby.util.ByteList transcode(ThreadContext context,
                                         org.jruby.util.ByteList value)

Specified by:

transcode in class Transcoder

transcode

public org.jruby.util.ByteList transcode(ThreadContext context,
                                         org.jruby.util.ByteList value,
                                         boolean is7BitASCII)

Specified by:

transcode in class Transcoder

convert

public org.jruby.util.ByteList convert(ThreadContext context,
                                       org.jruby.util.ByteList value,
                                       boolean is7BitASCII)

Specified by:

convert in class Transcoder

econvStrConvert

public org.jruby.util.ByteList econvStrConvert(ThreadContext context,
                                               org.jruby.util.ByteList value,
                                               boolean finish)

Specified by:

econvStrConvert in class Transcoder

transcode

private RubyCoderResult transcode(ThreadContext context,
                                  org.jruby.util.ByteList inBuffer,
                                  org.jruby.util.ByteList outBuffer,
                                  org.jcodings.Encoding inEncoding,
                                  boolean is7BitASCII,
                                  boolean finish)

primitiveConvert

public RubyCoderResult primitiveConvert(ThreadContext context,
                                        org.jruby.util.ByteList inBuffer,
                                        org.jruby.util.ByteList outBuffer,
                                        int outOffset,
                                        int outLimit,
                                        org.jcodings.Encoding inEncoding,
                                        boolean is7BitASCII,
                                        int flags)

Specified by:

primitiveConvert in class Transcoder

finish

public org.jruby.util.ByteList finish(org.jcodings.Encoding altEncoding)

Specified by:

finish in class Transcoder

getLastResult

public RubyCoderResult getLastResult()

Overrides:

getLastResult in class Transcoder

getLastError

public RaiseException getLastError()

Overrides:

getLastError in class Transcoder

getReplaceWith

public java.lang.String getReplaceWith()

createLastError

private void createLastError()

createTranscoder

private void createTranscoder(org.jcodings.Encoding inEncoding,
                              org.jcodings.Encoding outEncoding,
                              CharsetTranscoder.CodingActions actions,
                              boolean is7BitASCII)

stringFromCoderResult

public static java.lang.String stringFromCoderResult(java.nio.charset.CoderResult coderResult,
                                                     int flags,
                                                     boolean binaryToCharacter)

replaceStringFromActions

private static java.lang.String replaceStringFromActions(CharsetTranscoder.CodingActions actions,
                                                         java.nio.charset.Charset outCharset)

getCodingErrorActions

public CharsetTranscoder.CodingActions getCodingErrorActions()

processCodingErrorActions

public static CharsetTranscoder.CodingActions processCodingErrorActions(ThreadContext context,
                                                                        int flags,
                                                                        IRubyObject replace)

processCodingErrorActions

public static CharsetTranscoder.CodingActions processCodingErrorActions(ThreadContext context,
                                                                        IRubyObject opts)

transcodeCharsetFor

public static java.nio.charset.Charset transcodeCharsetFor(Ruby runtime,
                                                           byte[] name,
                                                           org.jcodings.Encoding encoding,
                                                           boolean is7Bit)