Overview  Package   Class  Use  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

r01f.util.types
Class Strings.StringWrapper

java.lang.Object
  extended by r01f.util.types.Strings.StringWrapper
All Implemented Interfaces:
java.lang.CharSequence
Direct Known Subclasses:
Strings.StringXMLOpsWrapper
Enclosing class:
Strings
public static class Strings.StringWrapper
extends java.lang.Object
implements java.lang.CharSequence

Field Summary
protected  java.lang.StringBuilder string
           
 
Constructor Summary
Strings.StringWrapper(java.lang.CharSequence... theStrings)
           
Strings.StringWrapper(java.lang.CharSequence theString)
           
Strings.StringWrapper(int size)
           
Strings.StringWrapper(int size, java.lang.CharSequence theString)
           
 
Method Summary
private  void _createBuffer(int size)
           
 Strings.StringWrapper add(char[] other)
          Añade un array de chars
 Strings.StringWrapper add(char[] other, int start, int end)
          Añade una porcion de un array de chars
 Strings.StringWrapper add(java.lang.CharSequence... others)
          Añade varias cadenas
 Strings.StringWrapper add(java.lang.CharSequence other)
          Añade una cadena
 Strings.StringWrapper add(java.lang.CharSequence other, int start, int end)
          Añade una subcadena de una cadena
 Strings.StringWrapper add(java.lang.Number num)
          Añade un numero
 Strings.StringWrapper addCustomized(java.lang.CharSequence other, java.lang.CharSequence... vars)
          Añade una cadena remplazando "placeholders" como {} por las variables que se pasan Ej: Strings.of("Hola {} hoy es {}","Alex","Sabado"}
 Strings.StringWrapper addLine(java.lang.CharSequence line)
          Añade una linea
 Strings.StringWrapper addQuoted(java.lang.CharSequence other)
          Añade una cadena entrecomillada
 char[] asCharArray()
          Devuelve como un array de caracteres
 java.io.InputStream asInputStream()
          Devuelve un InputStream a la cadena subyacente
 java.io.InputStream asInputStream(java.nio.charset.Charset charset)
          Devuelve un InputStream a la cadena subyacente
 java.io.Reader asReader()
          Devuelve un Reader a la cadena subyacente
 java.lang.String asString()
          Devuelve como String
 java.lang.StringBuffer asStringBuffer()
          Devuelve como un StringBuffers
 java.lang.StringBuilder asStringBuilder()
          Devuelve como un StringBuilder
 Strings.StringXMLOpsWrapper asXml()
          Activa las funciones específicas para cadenas XML
 char charAt(int index)
           
 Strings.StringWrapper customizeWith(java.lang.CharSequence... vars)
          Customiza el buffer remplazando "placeholders" como {} por las variables que se pasan Ej: Strings.of("Hola {} hoy es {}","Alex","Sabado"}
 Strings.StringWrapper decodeUsing(TextEncoder decoder)
          Decodifica el texto utilizando el decodificador que se pasa como parametro
 Strings.StringWrapper encode(java.nio.charset.Charset encoding)
          Codifica la cadena NOTA: Para cargar la cadena, utilizar Charset.forName("el nombre")
 Strings.StringWrapper encodeISO8859()
          Codifica la cadena en ISO-8859-1
 Strings.StringWrapper encodeUsing(TextEncoder encoder)
          Codifica el texto utilizando el codificador que se pasa como parametro
 Strings.StringWrapper encodeUTF8()
          Codifica la cadena en UTF-8
 Strings.StringWrapper filterAndReplaceChars(char[] charsToFilter, java.lang.String[] charsFiltered)
          Filtra caracteres y los sustituye por otros
 Strings.StringWrapper format(java.util.Locale l, java.lang.Object args)
          Formatea la cadena al estilo C (ver http://download.oracle.com/javase/1.5.0/docs/api/index.html?
 Strings.StringWrapper format(java.lang.Object args)
          Formatea la cadena al estilo C (ver http://download.oracle.com/javase/1.5.0/docs/api/index.html?
 byte[] getBytes()
          Devuelve como array de bytes utilizando el encoding por defecto
 byte[] getBytes(java.nio.charset.Charset charset)
          Devuelve como array de bytes utilizando el encoding especificado
 Strings.StringWrapper leftPad(char c, int length)
          Añade tantos caracteres c a la derecha de la cadena como sea necesario para llegar al tamaño length (si la cadena tiene un tamaño mayor o igual que length, NO rellena nada)
 int length()
           
 java.util.regex.Matcher matcher(java.lang.String regEx)
          Devuelve un matcher sobre la cadena
 Strings.StringWrapper quote()
          Rodea la cadena entre comillas
 Strings.StringWrapper quote(java.lang.String q)
          Rodea la cadena entre un caracter que se pasa
 Strings.StringWrapper removeAccents()
          Elimina los acentos de la cadena y los remplaza por su equivalente sin acento
 Strings.StringWrapper replaceAll(java.lang.String regex, java.lang.String replacement)
          Realiza una sustitución de caracteres en la cadena utilizando una expresion regular
 Strings.StringWrapper rightPad(char c, int length)
          Añade tantos caracteres c a la derecha de la cadena como sea necesario para llegar al tamaño length (si la cadena tiene un tamaño mayor o igual que length, NO rellena nada)
 void save(java.io.File f)
          Guarda la cadena en un fichero
 void save(java.lang.String filePath)
          Guarda la cadena en un fichero
 Strings.SplitterWrapper splitter(char separator)
          Devuelve un splitter sobre la cadena en base al caracter que se pasa
 Strings.SplitterWrapper splitter(com.google.common.base.CharMatcher separatorMatcher)
          Devuelve un splitter sobre la cadena en base a cualquier caracter que cumpla el matcher
 Strings.SplitterWrapper splitter(int chunksLength)
          Devuelve un splitter que trocea la cadena en trozos iguales del tamaño que se pasa (el último trozo obviamente puede ser de menor tamaño)
 Strings.SplitterWrapper splitter(java.util.regex.Pattern separatorPattern)
          Devuelve un splitter sobre la cadena en base a cualquier cadena que cumpla el patron
 Strings.SplitterWrapper splitter(java.lang.String separator)
          Devuelve un splitter sobre la cadena en base a la cadena que se pasaq
 java.lang.CharSequence subSequence(int start, int end)
           
 java.lang.String toString()
           
 Strings.StringWrapper trim()
          Elimina los espacios en blanco
 Strings.StringWrapper urlDecode()
          Decodifica una cadena que llega en formato www-form-urlencodec
 Strings.StringWrapper urlEncode()
          Codifica una cadena al formato www-form-urlencodec
 Strings.StringWrapper windows1252ToIso8859()
          Elimina algunos caracteres "especiales" del juego de caracteres utilizados en windows que es un super-conjunto del ISO8859
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

string

protected java.lang.StringBuilder string
Constructor Detail

Strings.StringWrapper

Strings.StringWrapper(int size)

Strings.StringWrapper

Strings.StringWrapper(int size,
                      java.lang.CharSequence theString)

Strings.StringWrapper

Strings.StringWrapper(java.lang.CharSequence theString)

Strings.StringWrapper

Strings.StringWrapper(java.lang.CharSequence... theStrings)
Method Detail

_createBuffer

private void _createBuffer(int size)

charAt

public char charAt(int index)
Specified by:
charAt in interface java.lang.CharSequence

length

public int length()
Specified by:
length in interface java.lang.CharSequence

subSequence

public java.lang.CharSequence subSequence(int start,
                                          int end)
Specified by:
subSequence in interface java.lang.CharSequence

toString

public java.lang.String toString()
Specified by:
toString in interface java.lang.CharSequence
Overrides:
toString in class java.lang.Object

format

public Strings.StringWrapper format(java.util.Locale l,
                                    java.lang.Object args)
Formatea la cadena al estilo C (ver http://download.oracle.com/javase/1.5.0/docs/api/index.html?java/util/Formatter.html) Ej: Calendar cal = new GregorianCalendar(1995, MAY, 23) Strings.create("Duke's Birthday: %1$tm %1$te,%1$tY").format(Locale.US,cal).asString(); // --> s == "Duke's Birthday: May 23, 1995"

Parameters:
l -
format -
args -
Returns:

format

public Strings.StringWrapper format(java.lang.Object args)
Formatea la cadena al estilo C (ver http://download.oracle.com/javase/1.5.0/docs/api/index.html?java/util/Formatter.html) Ej: Calendar cal = new GregorianCalendar(1995, MAY, 23) Strings.create("Duke's Birthday: %1$tm %1$te,%1$tY").format(cal).asString(); // --> s == "Duke's Birthday: May 23, 1995"

Parameters:
l -
format -
args -
Returns:

asString

public java.lang.String asString()
Devuelve como String

getBytes

public byte[] getBytes()
Devuelve como array de bytes utilizando el encoding por defecto

getBytes

public byte[] getBytes(java.nio.charset.Charset charset)
Devuelve como array de bytes utilizando el encoding especificado

Parameters:
charset - el encoding de salida

asStringBuilder

public java.lang.StringBuilder asStringBuilder()
Devuelve como un StringBuilder

asStringBuffer

public java.lang.StringBuffer asStringBuffer()
Devuelve como un StringBuffers

asCharArray

public char[] asCharArray()
Devuelve como un array de caracteres

asInputStream

public java.io.InputStream asInputStream()
Devuelve un InputStream a la cadena subyacente

asInputStream

public java.io.InputStream asInputStream(java.nio.charset.Charset charset)
Devuelve un InputStream a la cadena subyacente

Parameters:
charset - el charset del inputStream

asReader

public java.io.Reader asReader()
Devuelve un Reader a la cadena subyacente

asXml

public Strings.StringXMLOpsWrapper asXml()
Activa las funciones específicas para cadenas XML

urlEncode

public Strings.StringWrapper urlEncode()
                                throws org.apache.commons.codec.EncoderException
Codifica una cadena al formato www-form-urlencodec

Returns:
la cadena codificada
Throws:
org.apache.commons.codec.EncoderException - si NO se puede realizar la codificación

urlDecode

public Strings.StringWrapper urlDecode()
                                throws org.apache.commons.codec.DecoderException
Decodifica una cadena que llega en formato www-form-urlencodec

Returns:
la cadena decodificada
Throws:
org.apache.commons.codec.DecoderException - si NO se puede realizar la decodificación

encode

public Strings.StringWrapper encode(java.nio.charset.Charset encoding)
Codifica la cadena NOTA: Para cargar la cadena, utilizar Charset.forName("el nombre")

Parameters:
encoding - la codificación

encodeUTF8

public Strings.StringWrapper encodeUTF8()
Codifica la cadena en UTF-8

encodeISO8859

public Strings.StringWrapper encodeISO8859()
Codifica la cadena en ISO-8859-1

windows1252ToIso8859

public Strings.StringWrapper windows1252ToIso8859()
Elimina algunos caracteres "especiales" del juego de caracteres utilizados en windows que es un super-conjunto del ISO8859

filterAndReplaceChars

public Strings.StringWrapper filterAndReplaceChars(char[] charsToFilter,
                                                   java.lang.String[] charsFiltered)
Filtra caracteres y los sustituye por otros

Parameters:
charsToFilter - caracteres a filtrar
charsFiltered - caracteres a sustituir por los filtrados

removeAccents

public Strings.StringWrapper removeAccents()
Elimina los acentos de la cadena y los remplaza por su equivalente sin acento

replaceAll

public Strings.StringWrapper replaceAll(java.lang.String regex,
                                        java.lang.String replacement)
Realiza una sustitución de caracteres en la cadena utilizando una expresion regular

Parameters:
regex - la expresión regular con el patrón a remplazar
replacement - la cadena que remplaza los matches

save

public void save(java.io.File f)
          throws java.io.IOException
Guarda la cadena en un fichero

Parameters:
f - el fichero al que se guarda
Throws:
java.io.IOException - si no se puede guardar

save

public void save(java.lang.String filePath)
          throws java.io.IOException
Guarda la cadena en un fichero

Parameters:
filePath - la ruta al fichero
Throws:
java.io.IOException - si no se puede guardar

add

public Strings.StringWrapper add(java.lang.CharSequence other)
Añade una cadena

Parameters:
other -

addCustomized

public Strings.StringWrapper addCustomized(java.lang.CharSequence other,
                                           java.lang.CharSequence... vars)
Añade una cadena remplazando "placeholders" como {} por las variables que se pasan Ej: Strings.of("Hola {} hoy es {}","Alex","Sabado"}

Parameters:
other - la cadena a customizar
vars - las variables a sustituir

customizeWith

public Strings.StringWrapper customizeWith(java.lang.CharSequence... vars)
Customiza el buffer remplazando "placeholders" como {} por las variables que se pasan Ej: Strings.of("Hola {} hoy es {}","Alex","Sabado"}

Parameters:
vars - las variables a sustituir

add

public Strings.StringWrapper add(java.lang.Number num)
Añade un numero

Parameters:
num -
Returns:

add

public Strings.StringWrapper add(char[] other)
Añade un array de chars

Parameters:
other - el array de chars

add

public Strings.StringWrapper add(java.lang.CharSequence other,
                                 int start,
                                 int end)
Añade una subcadena de una cadena

Parameters:
other -
start - posicion inicial de la otra cadena a añadir
end - posicion final de la otra cadena a añadir

add

public Strings.StringWrapper add(char[] other,
                                 int start,
                                 int end)
Añade una porcion de un array de chars

Parameters:
other - el array de chars
start - la posicion inicial dentro del array
end - la posicion final dentro del array

addLine

public Strings.StringWrapper addLine(java.lang.CharSequence line)
Añade una linea

Parameters:
line -

addQuoted

public Strings.StringWrapper addQuoted(java.lang.CharSequence other)
Añade una cadena entrecomillada

Parameters:
other - cadena que se añade entrecomillada

add

public Strings.StringWrapper add(java.lang.CharSequence... others)
Añade varias cadenas

Parameters:
others -

rightPad

public Strings.StringWrapper rightPad(char c,
                                      int length)
Añade tantos caracteres c a la derecha de la cadena como sea necesario para llegar al tamaño length (si la cadena tiene un tamaño mayor o igual que length, NO rellena nada)

Parameters:
c - el caracter de relleno
length - el tamaño final de la cadena

leftPad

public Strings.StringWrapper leftPad(char c,
                                     int length)
Añade tantos caracteres c a la derecha de la cadena como sea necesario para llegar al tamaño length (si la cadena tiene un tamaño mayor o igual que length, NO rellena nada)

Parameters:
c - el caracter de relleno
length - el tamaño final de la cadena

quote

public Strings.StringWrapper quote()
Rodea la cadena entre comillas

quote

public Strings.StringWrapper quote(java.lang.String q)
Rodea la cadena entre un caracter que se pasa

Parameters:
q - el caracter a rodear

trim

public Strings.StringWrapper trim()
Elimina los espacios en blanco

encodeUsing

public Strings.StringWrapper encodeUsing(TextEncoder encoder)
Codifica el texto utilizando el codificador que se pasa como parametro

Parameters:
encoder - el codificador

decodeUsing

public Strings.StringWrapper decodeUsing(TextEncoder decoder)
Decodifica el texto utilizando el decodificador que se pasa como parametro

Parameters:
decoder - decodificador

splitter

public Strings.SplitterWrapper splitter(int chunksLength)
Devuelve un splitter que trocea la cadena en trozos iguales del tamaño que se pasa (el último trozo obviamente puede ser de menor tamaño)

Parameters:
chunksLength - el tamaño de los trozos

splitter

public Strings.SplitterWrapper splitter(char separator)
Devuelve un splitter sobre la cadena en base al caracter que se pasa

Parameters:
separator - el caracter separador de los trozos

splitter

public Strings.SplitterWrapper splitter(com.google.common.base.CharMatcher separatorMatcher)
Devuelve un splitter sobre la cadena en base a cualquier caracter que cumpla el matcher

Parameters:
separatorMatcher - un matcher del caracter separador de los trozos

splitter

public Strings.SplitterWrapper splitter(java.lang.String separator)
Devuelve un splitter sobre la cadena en base a la cadena que se pasaq

Parameters:
separator - la cadena separadora de los trozos

splitter

public Strings.SplitterWrapper splitter(java.util.regex.Pattern separatorPattern)
Devuelve un splitter sobre la cadena en base a cualquier cadena que cumpla el patron

Parameters:
separatorPattern - un patrón que ha de cumplir la cadena separadora de los trozos

matcher

public java.util.regex.Matcher matcher(java.lang.String regEx)
Devuelve un matcher sobre la cadena

Parameters:
regEx - la expresion regular
Overview  Package   Class  Use  Tree  Deprecated  Index  Help 
 PREV CLASS   NEXT CLASS FRAMES    NO FRAMES    
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD