- * Classe que representa um problema ocorrido dentro de qualquer parte (pacote) - * do projeto JRimum - *
- * - * - *
- * Qualquer exceção que ocorra dentro do componente JRimum é sempre
- * wrapped por uma instância de uma JRimumException.
- *
- * try {
- * execute();
- * } catch (IllegalArgumentException e) {
- * throw new JRimumException("Problema", e);
- * }
- *
- *
- * @author Gilmar P.S.L.
- *
- * @since 0.2
- *
- * @version 0.2
- *
- * @see java.lang.RuntimeException
- */
-
-public class JRimumException extends RuntimeException {
-
- /**
- * Serial version.
- */
- private static final long serialVersionUID = 1L;
-
- /**
- *
- * @see java.lang.RuntimeException#RuntimeException()
- *
- * @since 0.2
- */
- public JRimumException() {
- super();
- // Nothing to do.
- }
-
- /**
- * @param message
- * @param cause
- *
- * @see java.lang.RuntimeException#RuntimeException(String, Throwable)
- *
- * @since 0.2
- */
- public JRimumException(String message, Throwable cause) {
- super(message, cause);
- // Nothing to do.
- }
-
- /**
- * @param message
- *
- * @see java.lang.RuntimeException#RuntimeException(String)
- *
- * @since 0.2
- */
- public JRimumException(String message) {
- super(message);
- // Nothing to do.
- }
-
- /**
- * @param cause
- *
- * @see java.lang.RuntimeException#RuntimeException(Throwable)
- *
- * @since 0.2
- */
- public JRimumException(Throwable cause) {
- super(cause);
- // Nothing to do.
- }
-
-}
diff --git a/src/br/com/nordestefomento/jrimum/overview.html b/src/br/com/nordestefomento/jrimum/overview.html
deleted file mode 100644
index 8408969..0000000
--- a/src/br/com/nordestefomento/jrimum/overview.html
+++ /dev/null
@@ -1,21 +0,0 @@
-
-
--JRimum é um projeto fruto da iniciativa conjunta entre Grupo JRimum e a Nordeste Fomento Mercantil -objetivando a criação de componentes reutilizáveis Java com foco no domínio de negócios do Brasil. -
- -
-
-
-
-
-
-
-
diff --git a/src/br/com/nordestefomento/jrimum/package.html b/src/br/com/nordestefomento/jrimum/package.html
deleted file mode 100644
index 5e4eb1c..0000000
--- a/src/br/com/nordestefomento/jrimum/package.html
+++ /dev/null
@@ -1,40 +0,0 @@
-
-
-
-Este pacote contém as classes e interfaces que devem ser herdadas e impelementadas por qualquer outra classe ou interface deste projeto.
-
-
diff --git a/src/br/com/nordestefomento/jrimum/utilix/AbstractLineOfFields.java b/src/br/com/nordestefomento/jrimum/utilix/AbstractLineOfFields.java
deleted file mode 100644
index ce94fea..0000000
--- a/src/br/com/nordestefomento/jrimum/utilix/AbstractLineOfFields.java
+++ /dev/null
@@ -1,453 +0,0 @@
-/*
- * Copyright 2008 JRimum Project
- *
- * Licensed 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.
- *
- * Created at: 30/03/2008 - 18:17:32
- *
- * ================================================================================
- *
- * Direitos autorais 2008 JRimum Project
- *
- * Licenciado sob a Licença Apache, Versão 2.0 ("LICENÇA"); você não pode usar
- * esse arquivo exceto em conformidade com a esta LICENÇA. Você pode obter uma
- * cópia desta LICENÇA em http://www.apache.org/licenses/LICENSE-2.0 A menos que
- * haja exigência legal ou acordo por escrito, a distribuição de software sob
- * esta LICENÇA se dará “COMO ESTÁ”, SEM GARANTIAS OU CONDIÇÕES DE QUALQUER
- * TIPO, sejam expressas ou tácitas. Veja a LICENÇA para a redação específica a
- * reger permissões e limitações sob esta LICENÇA.
- *
- * Criado em: 30/03/2008 - 18:17:32
- *
- */
-
-
-package br.com.nordestefomento.jrimum.utilix;
-
-import static br.com.nordestefomento.jrimum.utilix.ObjectUtil.isNotNull;
-
-import java.util.ArrayList;
-import java.util.Collection;
-import java.util.Iterator;
-import java.util.List;
-import java.util.ListIterator;
-
-import org.apache.commons.lang.StringUtils;
-import org.apache.log4j.Logger;
-
-
-/**
- *
- * Descrição:
- *
- *
- * @author Gilmar P.S.L
- * @author Misael Barreto
- * @author Rômulo Augusto
- * @author Nordeste Fomento
- * Mercantil
- *
- * @since 0.2
- *
- * @version 0.2
- */
-public abstract class AbstractLineOfFields implements TextStream, List
--
- Bopepo é o primeiro componente disponibilizado pelo projeto com a finalidade de gerar boletos bancários. -
--A biblioteca é focada em negócios,mas também contém classes utilitárias de propósito geral. -
-- * Esta classe tem a responsabilidade de prover serviços utilitários - * do universo bancário, como por exemplo calcular o fator de vencimento. - *
- * - * @author Gilmar P.S.L - * @author Misael Barreto - * @author Rômulo Augusto - * @author Nordeste Fomento Mercantil - * - * @since 0.2 - * - * @version 0.2 - */ -public class BancoUtil { - - /** - * - */ - private static final long serialVersionUID = 1L; - - /** - *- * Data base para o cálculo do fator de vencimento fixada em 07.10.1997 - * (03.07.2000 retrocedidos 1000 dias do início do processo) segundo a FEBRABAN. - *
- */ - private static final Date DATA_BASE_DO_FATOR_DE_VENCIMENTO = new GregorianCalendar(1997, Calendar.OCTOBER, 7).getTime(); - - private static final Date DATA_LIMITE_DO_FATOR_DE_VENCIMENTO = new GregorianCalendar(2025, Calendar.FEBRUARY, 21).getTime(); - - /** - * - *- * Calcula o fator de vencimento, com base na subtração entre a - * DATA DE VENCIMENTO do título e a DATA BASE , fixada em - * 07.10.1997 (03.07.2000 retrocedidos 1000 dias do início do processo). - * Trata-se de um referencial numérico de 4 dígitos, situado nas - * quatro primeiras posições do campo “valor”, que representa a - * quantidade de dias decorridos da data base à data de vencimento - * do título. - *
- *
- * Os bloquetos de cobrança emitidos a partir de 1º de setembro
- * de 2000 (primeiro dia útil = 03/07/2000 - SEGUNDA) OBRIGATORIAMENTE
- * devem conter essas características, para que quando
- * forem capturados pela rede bancária, os sistemas possam realizar
- * operação inversa, ou seja, adicionar à data base o fator de
- * vencimento capturado, obtendo, dessa forma, a data do
- * vencimento do bloqueto.
- *
- * Exemplos: 03/07/2000(Fator = 1000), 05/07/2000(Fator = 1002),
- * 01/05/2002 (Fator = 1667), 05/07/2000(Fator = 1002)
- * e 21/02/2025(Fator = 9999).
- *
- * Observações: - *
-
- *
- - * A data base para o cálculo do fator de vencimento é - * 07/10/1997 (Fator de vencimento = 0).Caso a data de - * vencimento seja anterior a data base, uma exceção do tipo - * IllegalArgumentException será lançada. - * - *
- - * A data limite para o cálculo do fator de vencimento é - * 21/02/2025 (Fator de vencimento = 9999) Caso a data de - * vencimento seja posterior a data limite, uma exceção do tipo - * IllegalArgumentException será lançada. - * - *
- Na leitura para realizar o
parse da String.- Na escrita para transformar o objeto em uma String e assim ser possível tratá-la para ser escrita. - * - */ - private Format format; - - /** - * Preenchedor do value utilizado na hora da escrita. - */ - private Filler filler; - - /** - * Cria um
Field sem um formatador. Isto significa que a leitura da String
- * pelo objeto criado será como uma atribuição simples.
- * @param value Valor do campo
- * @param length Tamanho que o value deve possuir.
- */
- public Field(G value, Integer length){
-
- setValue(value);
- setLength(length);
- }
-
- /**
- * Cria um Field com um formatador. Isto significa que a leitura da String pelo
- * objeto criado será de acordo com o formatador.
- * @param value Valor do campo
- * @param length tamanho do campo
- * @param format Formatador que irá formatar a String fornecida na leitura para o value
- * especificado.
- */
- public Field(G value, Integer length, Format format){
-
- setLength(length);
- setValue(value);
- setFormat(format);
- }
-
- /**
- * Cria um Field com um preenchedor. Este preenchedor é utilizado na escrita do
- * Field quado é necessário preencher com caracteres especificados até o length definido.
- *
- * @param value valor do campo
- * @param length tamaho do campo
- * @param filler preenchedor
- */
- public Field(G value, Integer length, Filler filler){
-
- setLength(length);
- setValue(value);
- setFiller(filler);
- }
-
- /**
- * Cria um Field com um formatador e com um preenchedor.
- *
- * @param value Valor do campo
- * @param length Tamanho do campo
- * @param format Formatador que irá formatar a String fornecida na leitura para o value
- * especificado.
- * @param filler preenchedor
- */
- public Field(G value, Integer length, Format format, Filler filler){
-
- setLength(length);
- setValue(value);
- setFormat(format);
- setFiller(filler);
- }
-
-
- /**
- * Converte a String fornecida para o value representado pelo objeto.
- * - * A conversão é realizada a partir do formatador fornecido para o objeto. Se não houver - * formatador a String fornecida será atribuída como o valor do value. - * - * @param valueAsString valor do campo como uma String - */ - public void read(String valueAsString){ - - if (isNull(valueAsString)) { - throw new IllegalArgumentException("String inválida [ " + valueAsString + " ]!"); - } - - if (valueAsString.length() != length) { - throw new IllegalArgumentException("O tamanho da String [ " + valueAsString + " ] é incompatível com o especificado [ "+length+" ]!"); - } - - if (value instanceof TextStream) { - TextStream reader = (TextStream) value; - reader.read(valueAsString); - - } else if (value instanceof BigDecimal) { - - readDecimalField(valueAsString); - - } else if (value instanceof Date) { - - readDateField(valueAsString); - - } else { - - readStringOrNumericField(valueAsString); - } - } - - @SuppressWarnings("unchecked") - private void readStringOrNumericField(String valueAsString) { - - Class c = value.getClass(); - - for (Constructor cons : c.getConstructors()) { - - if (cons.getParameterTypes().length == 1){ - if (cons.getParameterTypes()[0].equals(String.class)){ - try { - - value = (G) cons.newInstance(valueAsString); - - } catch (IllegalArgumentException e) { - errorG(e, valueAsString).printStackTrace(); - } catch (InstantiationException e) { - errorG(e, valueAsString).printStackTrace(); - } catch (IllegalAccessException e) { - errorG(e, valueAsString).printStackTrace(); - } catch (InvocationTargetException e) { - errorG(e, valueAsString).printStackTrace(); - } - } - } - } - } - - @SuppressWarnings("unchecked") - private void readDateField(String valueAsString){ - - try { - - value = (G) format.parseObject(valueAsString); - } - catch (ParseException e) { - - errorG(e, valueAsString); - } - } - - @SuppressWarnings("unchecked") - private void readDecimalField(String valueAsString){ - - DecimalFormat decimalFormat = (DecimalFormat) format; - - try { - - Long parsedValue = (Long) format.parseObject(valueAsString); - BigDecimal decimalValue = new BigDecimal(parsedValue.longValue()); - decimalValue = decimalValue.movePointLeft(decimalFormat.getMaximumFractionDigits()); - - value = (G) decimalValue; - - } - catch (ParseException e) { - - errorG(e, valueAsString); - } - } - - public String write(){ - - String str = null; - - if (value instanceof TextStream) { - - TextStream its = (TextStream) value; - - str = its.write(); - - } else if (value instanceof Date) { - - Date campoDate = (Date) value; - - if (campoDate.compareTo(DateUtil.DATE_NULL) == 0) { - str = StringUtils.EMPTY; - - } else { - str = format.format(value); - } - - } else if (value instanceof BigDecimal) { - str = StringUtils.replaceChars(value.toString(), ".", StringUtils.EMPTY); - - } else { - str = value.toString(); - } - - str = fill(str); - - if (str.length() != length) { - throw new IllegalArgumentException("O campo [ " + str - + " ] é incompatível com o especificado [" + length + "]!"); - } - - return StringUtil.eliminateAccent(str).toUpperCase(); - } - - private String fill(String str) { - - if(isNotNull(filler)) { - str = filler.fill(str, length); - } - - return str; - } - - public G getValue() { - return value; - } - - - public void setValue(G field) { - - if (isNotNull(field)) { - this.value = field; - - } else { - throw new IllegalArgumentException("Campo inválido [" + field + "]!"); - } - - } - - - public Integer getLength() { - return length; - } - - - public void setLength(Integer length) { - - if (length > 0) { - this.length = length; - - } else { - throw new IllegalArgumentException("Tamanho inválido [ " + length + " ]!"); - } - - } - - - public Format getFormat() { - return format; - } - - public void setFormat(Format format) { - - if (isNotNull(format)) { - this.format = format; - - } else { - throw new IllegalArgumentException("Formato inválido [ " + format + " ]!"); - } - } - - public Filler getFiller() { - return filler; - } - - public void setFiller(Filler filler) { - - if(isNotNull(filler)) { - this.filler = filler; - - } else { - throw new IllegalArgumentException("Filler inválido [ " + filler + " ]!"); - } - } - - private static Exception errorG(Exception e, String value){ - - StackTraceElement[] stackTrace = e.getStackTrace(); - e = new RuntimeException("Problemas entre instância e valor: [ " + value + " ]!\nCausado por: "+e.getCause()); - e.setStackTrace(stackTrace); - - return e; - } - - @Override - public String toString() { - return ObjectUtil.toString(this); - } -} \ No newline at end of file diff --git a/src/br/com/nordestefomento/jrimum/utilix/FileUtil.java b/src/br/com/nordestefomento/jrimum/utilix/FileUtil.java deleted file mode 100644 index f746192..0000000 --- a/src/br/com/nordestefomento/jrimum/utilix/FileUtil.java +++ /dev/null @@ -1,578 +0,0 @@ -/* - * Copyright 2008 JRimum Project - * - * Licensed 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. - * - * Created at: 30/03/2008 - 18:17:54 - * - * ================================================================================ - * - * Direitos autorais 2008 JRimum Project - * - * Licenciado sob a Licença Apache, Versão 2.0 ("LICENÇA"); você não pode usar - * esse arquivo exceto em conformidade com a esta LICENÇA. Você pode obter uma - * cópia desta LICENÇA em http://www.apache.org/licenses/LICENSE-2.0 A menos que - * haja exigência legal ou acordo por escrito, a distribuição de software sob - * esta LICENÇA se dará “COMO ESTÁ”, SEM GARANTIAS OU CONDIÇÕES DE QUALQUER - * TIPO, sejam expressas ou tácitas. Veja a LICENÇA para a redação específica a - * reger permissões e limitações sob esta LICENÇA. - * - * Criado em: 30/03/2008 - 18:17:54 - * - */ - - -package br.com.nordestefomento.jrimum.utilix; - -import static br.com.nordestefomento.jrimum.utilix.ObjectUtil.isNotNull; - -import java.io.BufferedReader; -import java.io.ByteArrayOutputStream; -import java.io.File; -import java.io.FileInputStream; -import java.io.FileNotFoundException; -import java.io.FileOutputStream; -import java.io.FileReader; -import java.io.IOException; -import java.io.InputStream; -import java.io.OutputStream; -import java.nio.ByteBuffer; -import java.nio.channels.FileChannel; -import java.util.ArrayList; -import java.util.List; - -import org.apache.log4j.Logger; - -/** - * - * Descrição: - * - * - * @author Gilmar P.S.L - * @author Misael Barreto - * @author Rômulo Augusto - * @author Nordeste Fomento - * Mercantil - * - * @since 0.2 - * - * @version 0.2 - */ -public class FileUtil { - - //TODO Criar Metodo que recebe um arquivo e coisas para verificar nele, como: (isVazio,Numero de linhas, etc) - - protected static final Logger LOG = Logger.getLogger(FileUtil.class); - - /** - * - */ - private static final long serialVersionUID = 1227314921804015225L; - - private static final int EOF = -1; - - private static final int CARRIAGE_RETURN = 1; - - private static final int NEXT_LINE = 2; - - private static final String NEW_LINE = "\r\n"; - - /** - * Retorna o conteúdo de um arquivo em um array de bytes. - * - * @param file - * @return Array de bytes com o conteúdo de um File - * @throws IOException - */ - public static byte[] bytesFromFile(File file) throws IOException { - - - byte[] bytes = null; - - if(isNotNull(file)){ - - // medida do arquivo - long length = file.length(); - - // Nao se pode criar um array usando o tipo long. - // Tem que ser int. - // Antes de converter para o tipo int cheque - // para assegurar que file.lenth não é maior que Integer.MAX_VALUE. - if (length <= Integer.MAX_VALUE) { - - InputStream is = new FileInputStream(file); - - // para os dados - bytes = new byte[(int) length]; - - // leitura dos bytes - int offset = 0; - int numRead = 0; - - while ((offset < bytes.length) - && ((numRead = is.read(bytes, offset, bytes.length - offset)) >= 0)) { - offset += numRead; - } - - // Assegurando que todos os dados foram lidos - if (offset < bytes.length) { - throw new IOException("Não foi possível ler completamente o arquivo. [" - + file.getName() + "]"); - } - - // Feche o input stream - is.close(); - - }else - throw new IOException("O arquivo é muito grande para esta transformação."); - - } - - return bytes; - } - - /** - * Transforma um array de bytes em um arquivo. - * - * @param pathName - * @param bytes - * @return Objeto File com o conteúdo sendo o dos bytes - * @throws FileNotFoundException - * @throws IOException - */ - public static File bytes2File(String pathName, byte[] bytes) throws FileNotFoundException, IOException { - - File f = null; - - if(isNotNull(pathName,"pathName") && isNotNull(bytes,"bytes")){ - - f = new File(pathName); - - OutputStream out = new FileOutputStream(f); - - out.write(bytes); - out.flush(); - out.close(); - } - - return f; - } - - - - /** - *
- * Transforma um array de bytes em um ByteArrayOutputStream.
- *
- * Preenchedor de caracteres genérico. É utilizado para preencher objetos String,
- * tanto da esquerda para a direita como da direita para esquerda, com o objeto genérico até
- * o tamanho especificado. Caso o tamanho especificado seja menor
- * ou igual a 0 (ZERO), este valor será desconsiderado e nada será preenchido.
- *
- * É utilizado o método toString() do objeto preenchedor.
- *
- * Exemplo:
- *
- * Filler- * - * @author Gilmar P.S.L - * @author Misael Barreto - * @author Rômulo Augusto - * @author Nordeste Fomento - * Mercantil - * - * @since JRimum 1.0 - * - * @version 0.2 - * - */ -public class Fillerfiller = new Filler(new Integer(10), SideToFill.LEFT); - * String outPut = filler.fill("TESTE", 8); - * - * outPut -> "101TESTE" - *
- * Preenche o campo com o caracter especificado e no lado especificado. - *
- *
- * Exemplo:
- *
- * Se sideToFill == SideToFill.LEFT, o caracter especificado será adicionado à String
- * no lado esquerdo até que o campo fique com o tamanho que foi definido.
- *
- * Executa o método fill(String, int) passando o parâmetro
- * toFill como String.valueOf(toFill).
- *
- * Executa o método fill(String, int) passando o parâmetro
- * toFill como String.valueOf(toFill).
- *
- * Executa o método fill(String, int) passando o parâmetro
- * toFill como String.valueOf(toFill).
- *
- * Executa o método fill(String, int) passando o parâmetro
- * toFill como String.valueOf(toFill).
- *
- * Executa o método fill(String, int) passando o parâmetro
- * toFill como String.valueOf(toFill).
- *
- * Executa o método fill(String, int) passando o parâmetro
- * toFill como String.valueOf(toFill).
- *
- * Executa o método fill(String, int) passando o parâmetro
- * toFill como String.valueOf(toFill).
- *
- * Executa o método fill(String, int) passando o parâmetro
- * toFill como toFill.toString().
- *
- *
- * Caso toFill seja null, o método
- * fill(String, int) receberá uma String nula como parâmetro.
- *
- * Executa o método fill(String, int) passando o parâmetro
- * toFill como toFill.write().
- *
- *
- * Caso toFill seja null, o método
- * fill(String, int) receberá uma String nula como parâmetro.
- *
- * Lados para preencher. - *
- */ - public enum SideToFill{ - - LEFT, - RIGHT; - } - - @Override - public String toString() { - return ObjectUtil.toString(this); - } -} diff --git a/src/br/com/nordestefomento/jrimum/utilix/LocaleUtil.java b/src/br/com/nordestefomento/jrimum/utilix/LocaleUtil.java deleted file mode 100644 index 2a3d54b..0000000 --- a/src/br/com/nordestefomento/jrimum/utilix/LocaleUtil.java +++ /dev/null @@ -1,47 +0,0 @@ -/* - * Copyright 2008 JRimum Project - * - * Licensed 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. - * - * Created at: 04/04/2009 - 10:34:47 - * - * ================================================================================ - * - * Direitos autorais 2008 JRimum Project - * - * Licenciado sob a Licença Apache, Versão 2.0 ("LICENÇA"); você não pode - * usar esse arquivo exceto em conformidade com a esta LICENÇA. Você pode obter uma - * cópia desta LICENÇA em http://www.apache.org/licenses/LICENSE-2.0 A menos que - * haja exigência legal ou acordo por escrito, a distribuição de software sob esta - * LICENÇA se dará “COMO ESTÁ”, SEM GARANTIAS OU CONDIÇÕES DE QUALQUER TIPO, sejam - * expressas ou tácitas. Veja a LICENÇA para a redação específica a reger permissões - * e limitações sob esta LICENÇA. - * - * Criado em: 04/04/2009 - 10:34:47 - * - */ -package br.com.nordestefomento.jrimum.utilix; - -import java.util.Locale; - -/** - * - * @author Rômulo Augusto - * - * @version 0.2 - */ -public class LocaleUtil { - - public static final Locale PORTUGUESE = new Locale("pt"); - - public static final Locale PORTUGAL = new Locale("pt", "PT"); - - public static final Locale BRAZIL = new Locale("pt", "BR"); -} diff --git a/src/br/com/nordestefomento/jrimum/utilix/MonetaryUtil.java b/src/br/com/nordestefomento/jrimum/utilix/MonetaryUtil.java deleted file mode 100644 index 063db6d..0000000 --- a/src/br/com/nordestefomento/jrimum/utilix/MonetaryUtil.java +++ /dev/null @@ -1,70 +0,0 @@ -/* - * Copyright 2008 JRimum Project - * - * Licensed 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. - * - * Created at: 30/03/2008 - 18:18:00 - * - * ================================================================================ - * - * Direitos autorais 2008 JRimum Project - * - * Licenciado sob a Licença Apache, Versão 2.0 ("LICENÇA"); você não pode usar - * esse arquivo exceto em conformidade com a esta LICENÇA. Você pode obter uma - * cópia desta LICENÇA em http://www.apache.org/licenses/LICENSE-2.0 A menos que - * haja exigência legal ou acordo por escrito, a distribuição de software sob - * esta LICENÇA se dará “COMO ESTÁ”, SEM GARANTIAS OU CONDIÇÕES DE QUALQUER - * TIPO, sejam expressas ou tácitas. Veja a LICENÇA para a redação específica a - * reger permissões e limitações sob esta LICENÇA. - * - * Criado em: 30/03/2008 - 18:18:00 - * - */ - -package br.com.nordestefomento.jrimum.utilix; - -import java.text.DecimalFormat; -import java.text.DecimalFormatSymbols; -import java.text.NumberFormat; -import java.util.Locale; - - -public class MonetaryUtil { - - /** - * - */ - private static final long serialVersionUID = 3239576826390112911L; - - /** - * DecimalFormatSymbols com localização (Processo de localização) Brasil. - */ - public static final DecimalFormatSymbols BRASIL_DECIMAL_SYMBOLS = new DecimalFormatSymbols(new Locale("pt", "BR")); - - /** - * DecimalFormatSymbols com localização (Processo de localização) England. - */ - public static final DecimalFormatSymbols ENGLAND_DECIMAL_SYMBOLS = new DecimalFormatSymbols(new Locale("en", "US")); - - /** - * NumberFormat usado para formatar valores monetários em real. - */ - public static final NumberFormat FORMAT_REAL = new DecimalFormat("#,##0.00", BRASIL_DECIMAL_SYMBOLS); - - /** - * NumberFormat usado para formatar valores monetários em real com apenas UMA casa decimal. - */ - public static final NumberFormat FORMAT_REAL_UMA_CASA_DECIMAL = new DecimalFormat("#,##0.0", BRASIL_DECIMAL_SYMBOLS); - - /** - * NumberFormat usado para formatar valores monetários em real com o prefixo R$, exemplo: R$ 10,00. - */ - public static final NumberFormat FORMAT_REAL_COM_PREFIXO = new DecimalFormat("R$ #,##0.00", BRASIL_DECIMAL_SYMBOLS); - -} diff --git a/src/br/com/nordestefomento/jrimum/utilix/ObjectUtil.java b/src/br/com/nordestefomento/jrimum/utilix/ObjectUtil.java deleted file mode 100644 index 202ae9f..0000000 --- a/src/br/com/nordestefomento/jrimum/utilix/ObjectUtil.java +++ /dev/null @@ -1,200 +0,0 @@ -/* - * Copyright 2008 JRimum Project - * - * Licensed 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. - * - * Created at: 30/03/2008 - 18:02:40 - * - * ================================================================================ - * - * Direitos autorais 2008 JRimum Project - * - * Licenciado sob a Licença Apache, Versão 2.0 ("LICENÇA"); você não pode usar - * esse arquivo exceto em conformidade com a esta LICENÇA. Você pode obter uma - * cópia desta LICENÇA em http://www.apache.org/licenses/LICENSE-2.0 A menos que - * haja exigência legal ou acordo por escrito, a distribuição de software sob - * esta LICENÇA se dará “COMO ESTÁ”, SEM GARANTIAS OU CONDIÇÕES DE QUALQUER - * TIPO, sejam expressas ou tácitas. Veja a LICENÇA para a redação específica a - * reger permissões e limitações sob esta LICENÇA. - * - * Criado em: 30/03/2008 - 18:02:40 - * - */ - -package br.com.nordestefomento.jrimum.utilix; - -import java.io.Serializable; - -import org.apache.commons.lang.StringUtils; -import org.apache.commons.lang.builder.ToStringBuilder; -import org.apache.log4j.Logger; - -/** - * - *- * Classe raiz para todo o projeto detentora de metodos básicos e necessários. - *
- * - *
- * Todas as classes do projeto devem herdar de ObjectUtil
- * para reutilizar métodos como o toString() e
- * isNull(Object, String).
- *
- * Verifica a referência ao objeto e lança uma exceção para casos onde a - * referência é nula incluíndo na mensagem de exceção o nome do parâmetro - * passado. - *
- * - * @param object - * @param name - * - * @return (object == null ? true : false) - * - * @throws IllegalArgumentException - * - * @see #isNotNull(Object, String) - * - * @since 0.2 - */ - public static boolean isNull(Object object, String name) throws IllegalArgumentException { - - boolean is = true; - - if (object != null) { - is = false; - - } else { - - IllegalArgumentException e = new IllegalArgumentException( - (name != null ? name : "Objeto ") + " inválido : [" + object + "]!"); - - log.error(StringUtils.EMPTY, e); - - throw e; - } - - return is; - } - - /** - *- * Verifica a referência ao objeto e lança uma exceção para casos onde a - * referência é nula incluíndo na mensagem de exceção o nome do parâmetro - * passado. - *
- * - *
- * É o mesmo que usar !isNull(obj1,"obj1") a diferença é que
- * utiliza-se um símbolo ! a menos.
- *
- * Verifica a referência ao objeto. - *
- * - * @param object - * - * @return (object != null ? true : false) - * - * @see #isNull(Object) - * - * @since 0.2 - */ - public static boolean isNotNull(Object object) { - return (object != null); - } - - /** - *- * Verifica se existe uma referência ao objeto dado. - *
- * - * @param object - * - * @return (object != null ? true : false) - * - * @see #isNotNull(Object) - * - * @since 0.2 - */ - public static boolean exists(Object object) { - return (object != null); - } - - /** - *- * Verifica a referência ao objeto. - *
- * - * @param object - * - * @return (object == null ? true : false) - * - * @see #isNotNull(Object) - * - * @since 0.2 - */ - public static boolean isNull(Object object) { - return (object == null); - } - - /** - * Exibe os valores de instância para um objeto JRimum. - * - * @see org.apache.commons.lang.builder.ToStringBuilder#reflectionToString - * - * @since 0.2 - * - * @see #toString() - */ - public static String toString(Object obj) { - return "JRimumObject: " + ToStringBuilder.reflectionToString(obj); - } -} diff --git a/src/br/com/nordestefomento/jrimum/utilix/PDFUtil.java b/src/br/com/nordestefomento/jrimum/utilix/PDFUtil.java deleted file mode 100644 index eb5945e..0000000 --- a/src/br/com/nordestefomento/jrimum/utilix/PDFUtil.java +++ /dev/null @@ -1,215 +0,0 @@ -/* - * Copyright 2008 JRimum Project - * - * Licensed 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. - * - * Created at: 30/03/2008 - 23:49:00 - * - * ================================================================================ - * - * Direitos autorais 2008 JRimum Project - * - * Licenciado sob a Licença Apache, Versão 2.0 ("LICENÇA"); você não pode - * usar esse arquivo exceto em conformidade com a esta LICENÇA. Você pode obter uma - * cópia desta LICENÇA em http://www.apache.org/licenses/LICENSE-2.0 A menos que - * haja exigência legal ou acordo por escrito, a distribuição de software sob esta - * LICENÇA se dará “COMO ESTÁ”, SEM GARANTIAS OU CONDIÇÕES DE QUALQUER TIPO, sejam - * expressas ou tácitas. Veja a LICENÇA para a redação específica a reger permissões - * e limitações sob esta LICENÇA. - * - * Criado em: 30/03/2008 - 23:49:00 - * - */ - -package br.com.nordestefomento.jrimum.utilix; - -import static br.com.nordestefomento.jrimum.utilix.ObjectUtil.isNotNull; - -import java.io.ByteArrayOutputStream; -import java.util.ArrayList; -import java.util.List; - -import org.apache.log4j.Logger; - -import com.lowagie.text.Document; -import com.lowagie.text.DocumentException; -import com.lowagie.text.Image; -import com.lowagie.text.pdf.PdfCopy; -import com.lowagie.text.pdf.PdfImportedPage; -import com.lowagie.text.pdf.PdfReader; -import com.lowagie.text.pdf.PdfStamper; -import com.lowagie.text.pdf.SimpleBookmark; - - -/** - * - *- * DEFINIÇÃO DA CLASSE - *
- * - *- * OBJETIVO/PROPÓSITO - *
- * - *- * EXEMPLO: - *
- * - * @author Gilmar P.S.L. - * - * @since 0.2 - * - * @version 0.2 - */ - -public class PDFUtil { - - /** - * - */ - private static final long serialVersionUID = 1L; - - protected static final Logger LOG = Logger.getLogger(PDFUtil.class); - - public static RectanglePDF changeField2Image(PdfStamper stamper, float[] positions , Image image) throws DocumentException{ - - RectanglePDF rect = new RectanglePDF(positions); - - return changeField2Image(stamper,rect,image); - } - - public static RectanglePDF changeField2Image(PdfStamper stamper, - RectanglePDF rect, Image image) throws DocumentException { - - // Ajustando o tamanho da imagem de acordo com o tamanho do campo. - // image.scaleToFit(rect.getWidth(), rect.getHeight()); - image.scaleAbsolute(rect.getWidth(), rect.getHeight()); - - // A rotina abaixo tem por objetivo deixar a imagem posicionada no - // centro - // do field, tanto na perspectiva horizontal como na vertical. - // Caso não se queira mais posicionar a imagem no centro do field, basta - // efetuar a chamada a seguir: - // "image.setAbsolutePosition - // (rect.getLowerLeftX(),rect.getLowerLeftY());" - image.setAbsolutePosition(rect.getLowerLeftX() - + (rect.getWidth() - image.getScaledWidth()) / 2, rect - .getLowerLeftY() - + (rect.getHeight() - image.getScaledHeight()) / 2); - - // cb = stamper.getUnderContent(rect.getPage()); - stamper.getOverContent(rect.getPage()).addImage(image); - - return rect; - } - - /** - * Junta varios arquivos pdf em um soh. - * - * @param pdfFiles Lista de array de bytes - * - * @return Arquivo PDF em forma de byte - */ - @SuppressWarnings("unchecked") - public static byte[] mergeFiles(List- * SOBRE O MÉTODO - *
- * - * @return llx - lower left x - */ - public float getLowerLeftX(){ - return this.llx; - } - - /** - *- * SOBRE O MÉTODO - *
- * - * @return lly - lower left y - */ - public float getLowerLeftY(){ - return lly; - } - - /** - *- * SOBRE O MÉTODO - *
- * - * @return urx - upper right x - * - */ - public float getUpperRightX(){ - return urx; - } - - - /** - *- * SOBRE O MÉTODO - *
- * - * @return ury - upper right y - * - * @since 1.0 - */ - public float getUpperRightY(){ - return ury; - } - -} diff --git a/src/br/com/nordestefomento/jrimum/utilix/StringUtil.java b/src/br/com/nordestefomento/jrimum/utilix/StringUtil.java deleted file mode 100644 index f3671e9..0000000 --- a/src/br/com/nordestefomento/jrimum/utilix/StringUtil.java +++ /dev/null @@ -1,250 +0,0 @@ -/* - * Copyright 2008 JRimum Project - * - * Licensed 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. - * - * Created at: 30/03/2008 - 18:18:19 - * - * ================================================================================ - * - * Direitos autorais 2008 JRimum Project - * - * Licenciado sob a Licença Apache, Versão 2.0 ("LICENÇA"); você não pode usar - * esse arquivo exceto em conformidade com a esta LICENÇA. Você pode obter uma - * cópia desta LICENÇA em http://www.apache.org/licenses/LICENSE-2.0 A menos que - * haja exigência legal ou acordo por escrito, a distribuição de software sob - * esta LICENÇA se dará “COMO ESTÁ”, SEM GARANTIAS OU CONDIÇÕES DE QUALQUER - * TIPO, sejam expressas ou tácitas. Veja a LICENÇA para a redação específica a - * reger permissões e limitações sob esta LICENÇA. - * - * Criado em: 30/03/2008 - 18:18:19 - * - */ - - -package br.com.nordestefomento.jrimum.utilix; - -import static br.com.nordestefomento.jrimum.utilix.ObjectUtil.isNotNull; - -import org.apache.commons.lang.StringUtils; - - -/** - * - * Esta classe tem a responsabilidade de prover serviços utilitários - * relacionados a manipulação deStrings
- *
- *
- *
- * @author Gilmar P.S.L
- * @author Misael Barreto
- * @author Rômulo Augusto
- * @author Nordeste Fomento Mercantil
- *
- * @since 0.2
- *
- * @version 0.2
- */
-public class StringUtil {
-
- public static final String WHITE_SPACE = " ";
-
- /**
- *
- */
- private static final long serialVersionUID = 7425529940068032055L;
-
- /**
- * Construtor privado que previne a instanciação da classe até por reflection
- */
- private StringUtil() {
- throw new AssertionError();
- }
-
- /**
- * Elimina simbolos como:
- * ><,;.:!*&%+-_<>[]\/
- *
- * @param str String com os símbolos a serem removidos.
- * @return String sem símbolos.
- */
- public static String eliminateSymbols(final String str){
-
- String modifiedStr = str;
-
- if(isNotNull(modifiedStr)){
-
- modifiedStr = StringUtils.replace(str,"-", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,"_", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,"=", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,"+", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,"%", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,"*", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,"@", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,"#", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,"&", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,":", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,".", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,";", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,",", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,"!", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,"?", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,"(", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,")", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,"{", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,"}", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,"[", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,"]", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,"/", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,"\\", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,">", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,"<", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,"\"", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,"'", StringUtils.EMPTY);
- modifiedStr = StringUtils.replace(str,"`", StringUtils.EMPTY);
- }
-
- return modifiedStr;
- }
-
-
- /**
- *
- * Remove os zeros iniciais de uma String, seja ela numérica ou não.
- *
- * removeStartWithZeros("00000") => 0
- * removeStartWithZeros("00023") => 23
- * removeStartWithZeros("02003") => 2003
- *
- * @param str - * @return a string sem zeros inicias ou um único zero. - * - * @since 0.2 - */ - - public static String removeStartWithZeros(final String str){ - - String withoutZeros = StringUtils.EMPTY; - final String zero = "0"; - - if (isNotNull(str)) { - - if (StringUtils.startsWith(str, zero)) { - - withoutZeros = StringUtils.removeStart(str, zero); - - while (StringUtils.startsWith(withoutZeros, zero)) { - withoutZeros = StringUtils.removeStart(withoutZeros, zero); - } - - if(withoutZeros.trim().length() == 0) { - withoutZeros = zero; - } - - } else { - withoutZeros = str; - } - } - - return withoutZeros; - } - - /** - * Remove a acentuação do texto, que inclui os acentos: - *
-
- *
- Agudo. ex.: á - *
- Grave. ex.: à - *
- Til. ex.: ã - *
- Trema. ex.: ä - *
- Circunflexo. ex.: â - *
- * Os acentos são removidos tanto para letras minúsculas como para letras maiúsculas. - * - * @param value String com os caracteres a serem removidos. - * @return String sem acentuação. - */ - public static String eliminateAccent(final String value) { - - String modifiedValue = value; - - //Para ç e Ç - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00E7', 'c'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00C7', 'C'); - - //Para à, á, â, ã e ä - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00E0', 'a'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00E1', 'a'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00E2', 'a'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00E3', 'a'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00E4', 'a'); - - //Para è, é, ê e ë - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00E8', 'e'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00E9', 'e'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00EA', 'e'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00EB', 'e'); - - //Para ì, í, î e ï - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00EC', 'i'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00ED', 'i'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00EE', 'i'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00EF', 'i'); - - //Para ò, ó, ô, õ e ö - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00F2', 'o'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00F3', 'o'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00F4', 'o'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00F5', 'o'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00F6', 'o'); - - //Para ù, ú, û e ü - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00F9', 'u'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00FA', 'u'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00FB', 'u'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00FC', 'u'); - - //Para À, Á, Â, Ã e Ä - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00C0', 'A'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00C1', 'A'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00C2', 'A'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00C3', 'A'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00C4', 'A'); - - //Para È, É, Ê e Ë - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00C8', 'E'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00C9', 'E'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00CA', 'E'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00CB', 'E'); - - //Para Ì, Í, Î e Ï - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00CC', 'I'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00CD', 'I'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00CE', 'I'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00CF', 'I'); - - //Para Ò, Ó, Ô, Õ e Ö - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00D2', 'O'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00D3', 'O'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00D4', 'O'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00D5', 'O'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00D6', 'O'); - - //Para Ù, Ú, Û e Ü - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00D9', 'U'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00DA', 'U'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00DB', 'U'); - modifiedValue = StringUtils.replaceChars(modifiedValue, '\u00DC', 'U'); - - return modifiedValue; - } -} diff --git a/src/br/com/nordestefomento/jrimum/utilix/package.html b/src/br/com/nordestefomento/jrimum/utilix/package.html deleted file mode 100644 index 1af9f77..0000000 --- a/src/br/com/nordestefomento/jrimum/utilix/package.html +++ /dev/null @@ -1,49 +0,0 @@ - - - - -Este é um pacote da biblioteca JMatryx. - - -
-
-
-
-
-
diff --git a/src/main/java/org/jrimum/utilix/Arrays.java b/src/main/java/org/jrimum/utilix/Arrays.java
new file mode 100644
index 0000000..88ec658
--- /dev/null
+++ b/src/main/java/org/jrimum/utilix/Arrays.java
@@ -0,0 +1,412 @@
+/*
+ * Copyright 2010 JRimum Project
+ *
+ * Licensed 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.
+ *
+ * Created at: 01/08/2010 - 21:30:00
+ *
+ * ================================================================================
+ *
+ * Direitos autorais 2010 JRimum Project
+ *
+ * Licenciado sob a Licença Apache, Versão 2.0 ("LICENÇA"); você não pode usar
+ * esse arquivo exceto em conformidade com a esta LICENÇA. Você pode obter uma
+ * cópia desta LICENÇA em http://www.apache.org/licenses/LICENSE-2.0 A menos que
+ * haja exigência legal ou acordo por escrito, a distribuição de software sob
+ * esta LICENÇA se dará “COMO ESTÁ”, SEM GARANTIAS OU CONDIÇÕES DE QUALQUER
+ * TIPO, sejam expressas ou tácitas. Veja a LICENÇA para a redação específica a
+ * reger permissões e limitações sob esta LICENÇA.
+ *
+ * Criado em: 01/08/2010 - 21:30:00
+ *
+ */
+
+package org.jrimum.utilix;
+
+/**
+ * Detalhes:
- -+ * Classe utilitária para validações de arrays em geral. + *
+ * + *+ * Inicialmente fornece métodos booleanos para verificação da existência de elementos. + *
+ * + * @author Gilmar P.S.L. + * + * @since 0.2 + * + * @version 0.2 + */ +public final class Arrays { + + /** + * Utility class pattern: classe não instanciável + * + * @throws IllegalStateException + * Caso haja alguma tentativa de utilização deste construtor. + */ + private Arrays() { + + Exceptions.throwIllegalStateException("Instanciação não permitida!"); + } + + /** + *+ * Indica se um dado array de chars tem elementos sem gerar NPE. + *
+ *
+ * Resposta direta para o seguinte código:
+ * (a != null && a > 0).
+ *
+ * Indica se um dado array de booleans tem elementos sem gerar NPE. + *
+ *
+ * Resposta direta para o seguinte código:
+ * (a != null && a > 0).
+ *
+ * Indica se um dado array de bytes tem elementos sem gerar NPE. + *
+ *
+ * Resposta direta para o seguinte código:
+ * (a != null && a > 0).
+ *
+ * Indica se um dado array de shorts tem elementos sem gerar NPE. + *
+ *
+ * Resposta direta para o seguinte código:
+ * (a != null && a > 0).
+ *
+ * Indica se um dado array de ints tem elementos sem gerar NPE. + *
+ *
+ * Resposta direta para o seguinte código:
+ * (a != null && a > 0).
+ *
+ * Indica se um dado array de longs tem elementos sem gerar NPE. + *
+ *
+ * Resposta direta para o seguinte código:
+ * (a != null && a > 0).
+ *
+ * Indica se um dado array de floats tem elementos sem gerar NPE. + *
+ *
+ * Resposta direta para o seguinte código:
+ * (a != null && a > 0).
+ *
+ * Indica se um dado array de doubles tem elementos sem gerar NPE. + *
+ *
+ * Resposta direta para o seguinte código:
+ * (a != null && a > 0).
+ *
+ * Indica se um dado array de objetos tem elementos sem gerar NPE. + *
+ *
+ * Resposta direta para o seguinte código:
+ * (a != null && a > 0).
+ *
+ * Retorna a quantidade de elementos de um dado array sem gerar NPE. + *
+ *
+ * Resposta direata para o seguinte código:
+ * (a != null ? a.length : 0).
+ *
+ * Retorna a quantidade de elementos de um dado array sem gerar NPE. + *
+ *
+ * Resposta direata para o seguinte código:
+ * (a != null ? a.length : 0).
+ *
+ * Retorna a quantidade de elementos de um dado array sem gerar NPE. + *
+ *
+ * Resposta direata para o seguinte código:
+ * (a != null ? a.length : 0).
+ *
+ * Retorna a quantidade de elementos de um dado array sem gerar NPE. + *
+ *
+ * Resposta direata para o seguinte código:
+ * (a != null ? a.length : 0).
+ *
+ * Retorna a quantidade de elementos de um dado array sem gerar NPE. + *
+ *
+ * Resposta direata para o seguinte código:
+ * (a != null ? a.length : 0).
+ *
+ * Retorna a quantidade de elementos de um dado array sem gerar NPE. + *
+ *
+ * Resposta direata para o seguinte código:
+ * (a != null ? a.length : 0).
+ *
+ * Retorna a quantidade de elementos de um dado array sem gerar NPE. + *
+ *
+ * Resposta direata para o seguinte código:
+ * (a != null ? a.length : 0).
+ *
+ * Retorna a quantidade de elementos de um dado array sem gerar NPE. + *
+ *
+ * Resposta direata para o seguinte código:
+ * (a != null ? a.length : 0).
+ *
+ * Retorna a quantidade de elementos de um dado array sem gerar NPE. + *
+ *
+ * Resposta direata para o seguinte código:
+ * (a != null ? a.length : 0).
+ *
+ * Informando a classe há necessidade de informar o caminho do pacote, caso + * o recurso esteja nele. + *
+ * + * @param resourceName + * - O nome do resource a ser carregado + * @param callingClass + * - A classe do objeto chamador ou outro. + * @return URL para o recurso (resource). + */ + public static URL getResource(String resourceName, Class callingClass) { + + URL url = null; + + if (callingClass != null) { + + url = callingClass.getResource(resourceName); + + if (url == null) { + + url = callingClass.getClassLoader().getResource(resourceName); + + }else{ + + return url; + } + + if (url == null) { + + String inPagckage = format("%s/%s", callingClass.getPackage().getName().replaceAll("\\.", "/"), resourceName); + + url = Thread.currentThread().getContextClassLoader().getResource(inPagckage); + + } else { + + return url; + } + } + + if (url == null) { + + url = ClassLoaders.class.getResource(resourceName); + + }else{ + + return url; + } + + if (url == null) { + + url = ClassLoaders.class.getClassLoader().getResource(resourceName); + + }else{ + + return url; + } + + if (url == null) { + + url = Thread.currentThread().getContextClassLoader().getResource( + resourceName); + } + + return url; + } + + /** + * Carrega um recurso existente no classpath sob a forma de stream. + * + * @param resourceName + * - O nome do resource a ser carregado + * @return Stream aberto para o recurso (resource). + */ + public static InputStream getResourceAsStream(String resourceName) { + + return getResourceAsStream(resourceName, null); + } + + /** + * Carrega um recurso existente no classpath sob a forma de stream com ou + * sem uma classe informada. + * + * @param resourceName + * - O nome do resource a ser carregado + * @param callingClass + * - A classe do objeto chamador ou outro. + * @return Stream aberto para o recurso (resource). + */ + public static InputStream getResourceAsStream(String resourceName, + Class callingClass) { + + try { + + return getResource(resourceName, callingClass).openStream(); + + } catch (IOException e) { + + return Exceptions.throwIllegalStateException(e); + } + } + +} diff --git a/src/main/java/org/jrimum/utilix/Collections.java b/src/main/java/org/jrimum/utilix/Collections.java new file mode 100644 index 0000000..4d46883 --- /dev/null +++ b/src/main/java/org/jrimum/utilix/Collections.java @@ -0,0 +1,512 @@ +/* + * Copyright 2010 JRimum Project + * + * Licensed 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. + * + * Created at: 01/08/2010 - 21:30:00 + * + * ================================================================================ + * + * Direitos autorais 2010 JRimum Project + * + * Licenciado sob a Licença Apache, Versão 2.0 ("LICENÇA"); você não pode usar + * esse arquivo exceto em conformidade com a esta LICENÇA. Você pode obter uma + * cópia desta LICENÇA em http://www.apache.org/licenses/LICENSE-2.0 A menos que + * haja exigência legal ou acordo por escrito, a distribuição de software sob + * esta LICENÇA se dará “COMO ESTÁ”, SEM GARANTIAS OU CONDIÇÕES DE QUALQUER + * TIPO, sejam expressas ou tácitas. Veja a LICENÇA para a redação específica a + * reger permissões e limitações sob esta LICENÇA. + * + * Criado em: 01/08/2010 - 21:30:00 + * + */ + +package org.jrimum.utilix; + +import java.util.Collection; +import java.util.Map; + +/** + * Classe utilitária para validações de coleções em geral, com e sem exceções. + * + *+ * Fornece métodos booleanos e métodos que verificam se uma coleção está de + * acordo com o desejado e, caso não estejam, lançam exceção. + *
+ * + * @author Gilmar P.S.L. + * @author Rômulo Augusto + * + * @since 0.2 + * + * @version 0.2 + */ +public final class Collections { + + /** + * Utility class pattern: classe não instanciável + * + * @throws IllegalStateException + * Caso haja alguma tentativa de utilização deste construtor. + */ + private Collections() { + + Exceptions.throwIllegalStateException("Instanciação não permitida!"); + } + + /** + * Verifica se aCollection passada por parâmetro é
+ * null ou não possui elementos e lança
+ * exceção caso não preencha estes requisitos.
+ *
+ * @param collection
+ * - Instância de Collection analisada.
+ *
+ * @throws IllegalArgumentException - Caso a coleção não
+ * seja null e possua elementos.
+ *
+ * @see #checkEmpty(Collection, String)
+ * @see #isEmpty(Collection)
+ * @see #isNotEmpty(Collection)
+ *
+ * @since 0.2
+ */
+ public static void checkEmpty(Collection collection) {
+
+ checkEmpty(collection, "Collection não nulo e com elementos! Valor ["
+ + collection + "].");
+ }
+
+ /**
+ * Verifica se a Collection passado por parâmetro é
+ * null ou não possui elementos e lança
+ * exceção, com a mensagem informada, caso não preencha estes requisitos.
+ *
+ * @param collection
+ * - Instância de Collection analisada.
+ * @param message
+ * - Mensagem utilizada na exceção.
+ *
+ * @throws IllegalArgumentException - Caso a coleção não
+ * seja null e possua elementos.
+ *
+ * @see #isEmpty(Collection)
+ * @see #isNotEmpty(Collection)
+ *
+ * @since 0.2
+ */
+ public static void checkEmpty(Collection collection, String message) {
+
+ if (hasElement(collection)) {
+
+ Exceptions.throwIllegalArgumentException(message);
+ }
+ }
+
+ /**
+ * Verifica se a Collection passada por parâmetro
+ * não é null e possui elementos e lança
+ * exceção caso não preencha estes requisitos.
+ *
+ * @param collection
+ * - Instância de Collection analisada.
+ *
+ * @throws IllegalArgumentException
+ * - Caso a coleção seja null ou a coleção
+ * não possua elementos.
+ *
+ * @see #checkNotEmpty(Collection, String)
+ * @see #isEmpty(Collection)
+ * @see #isNotEmpty(Collection)
+ *
+ * @since 0.2
+ */
+ public static void checkNotEmpty(Collection collection) {
+
+ checkNotEmpty(collection, "Objeto nulo!", "Collection sem elementos!");
+ }
+
+ /**
+ * Verifica se a Collection passada por parâmetro
+ * não é null e possui elementos e lança
+ * exceção, com a mensagem informada, caso não preencha estes requisitos.
+ *
+ * @param collection
+ * - Instância de Collection analisada.
+ * @param message
+ * - Mensagem utiliada na exceção.
+ *
+ * @throws IllegalArgumentException
+ * - Caso a coleção seja null ou a coleção
+ * não possua elementos.
+ *
+ * @see #isEmpty(Collection)
+ * @see #isNotEmpty(Collection)
+ *
+ * @since 0.2
+ */
+ public static void checkNotEmpty(Collection collection, String message) {
+
+ checkNotEmpty(collection, message, message);
+ }
+
+ /**
+ * Verifica se o Map passado por parâmetro é null
+ * ou não possui elementos e lança exceção caso não
+ * preencha estes requisitos.
+ *
+ * @param map
+ * - Instância de Map analisada.
+ *
+ * @throws IllegalArgumentException - Caso o mapa não seja
+ * null e possua elementos.
+ *
+ * @see #checkEmpty(Map, String)
+ * @see #isEmpty(Map)
+ * @see #isNotEmpty(Map)
+ *
+ * @since 0.2
+ */
+ public static void checkEmpty(Map map) {
+
+ checkEmpty(map, "Map não nulo e com elementos. Valor [" + map + "]");
+ }
+
+ /**
+ * Verifica se o Map passado por parâmetro é null
+ * ou não possui elementos e lança exceção, com a mensagem
+ * informada, caso não preencha estes requisitos.
+ *
+ * @param map
+ * - Instância de Map analisada.
+ * @param message
+ * - Mensagem utilizada na exceção.
+ *
+ * @throws IllegalArgumentException - Caso o mapa não seja
+ * null e possua elementos.
+ *
+ * @see #isEmpty(Map)
+ * @see #isNotEmpty(Map)
+ *
+ * @since 0.2
+ */
+ public static void checkEmpty(Map map, String message) {
+
+ if (hasElement(map)) {
+
+ Exceptions.throwIllegalArgumentException(message);
+ }
+ }
+
+ /**
+ * Verifica se o Map passado por parâmetro não
+ * é null e possui elementos e lança exceção caso não preencha
+ * estes requisitos.
+ *
+ * @param map
+ * - Instância de Map analisada.
+ *
+ * @throws IllegalArgumentException
+ * - Caso o mapa seja null ou o mapa
+ * não possua elementos.
+ *
+ * @see #checkNotEmpty(Map, String)
+ * @see #isEmpty(Map)
+ * @see #isNotEmpty(Map)
+ *
+ * @since 0.2
+ */
+ public static void checkNotEmpty(Map map) {
+
+ checkNotEmpty(map, "Objeto nulo", "Map sem elementos");
+ }
+
+ /**
+ * Verifica se o Map passado por parâmetro não
+ * é null e possui elementos e lança exceção, com a mensagem
+ * informada, caso não preencha estes requisitos.
+ *
+ * @param map
+ * - Instância de Map analisada.
+ * @param message
+ * - Mensagem utiliada na exceção.
+ *
+ * @throws IllegalArgumentException
+ * - Caso o mapa seja null ou o mapa
+ * não possua elementos.
+ *
+ * @see #isEmpty(Map)
+ * @see #isNotEmpty(Map)
+ *
+ * @since 0.2
+ */
+ public static void checkNotEmpty(Map map, String message) {
+
+ checkNotEmpty(map, message, message);
+ }
+
+ /**
+ * Verifica se a Collection passada por parâmetro é
+ * null ou não possui elementos.
+ *
+ * @param collection
+ * - Instância de Collection analisada.
+ * @return !hasElement(collection)
+ *
+ * @since 0.2
+ */
+ public static boolean isEmpty(Collection collection) {
+
+ return !hasElement(collection);
+ }
+
+ /**
+ * Verifica se a Collection passada por parâmetro
+ * não é null e possui elementos.
+ *
+ * @param collection
+ * - Instância de Collection analisada.
+ * @return hasElement(collection)
+ *
+ * @see #isEmpty(Collection)
+ *
+ * @since 0.2
+ */
+ public static boolean isNotEmpty(Collection collection) {
+
+ return hasElement(collection);
+ }
+
+ /**
+ * Verifica se o Map passado por parâmetro é null
+ * ou não possui elementos.
+ *
+ * @param map
+ * - Instância de Map analisada.
+ * @return !hasElement(map)
+ *
+ * @since 0.2
+ */
+ public static boolean isEmpty(Map map) {
+
+ return !hasElement(map);
+ }
+
+ /**
+ * Verifica se o Map passado por parâmetro não
+ * é null e possui elementos.
+ *
+ * @param map
+ * - Instância de Map analisada.
+ * @return hasElement(map)
+ *
+ * @see #isEmpty(Map)
+ *
+ * @since 0.2
+ */
+ public static boolean isNotEmpty(Map map) {
+
+ return hasElement(map);
+ }
+
+ /**
+ * Indica se pelo menos uma coleção tem algum elemento sem gerar NPE.
+ *
+ * @param cols
+ * - Coleções para teste.
+ *
+ * @return indicativo
+ */
+ public static boolean hasElement(Collection ... cols) {
+
+ if(Arrays.hasElement(cols)){
+
+ for(Collection c : cols){
+ if(hasElement(c)){
+ return true;
+ }
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Indica se pelo menos um mapa tem algum elemento sem gerar NPE.
+ *
+ * @param maps
+ * - Mapas para teste.
+ *
+ * @return indicativo
+ */
+ public static boolean hasElement(Map ... maps) {
+
+ if(Arrays.hasElement(maps)){
+
+ for(Map m : maps){
+ if(hasElement(m)){
+ return true;
+ }
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Indica se uma dada coleção tem elementos sem gerar NPE.
+ *
+ * Resposta direta para o seguinte código:
+ * (c != null && !c.isEmpty()).
+ *
+ * Resposta direata para o seguinte código:
+ * (m != null && !m.isEmpty()).
+ *
+ * Resposta direata para o seguinte código:
+ * (c != null ? c.size() : 0).
+ *
+ * Resposta direata para o seguinte código:
+ * (m != null ? m.size() : 0).
+ *
null ou se é vazio.
+ *
+ * Caso o objeto seja null, lança
+ * NullPointerException com a mensagem informada no parâmetro
+ * messageNullPointer (primeiro parâmetro String). Caso o
+ * objeto não seja null e não possua elementos, lança
+ * IllegalArgumentException com a mensagem informada no
+ * parâmetro messageIllegalArgument (segundo parâmetro String).
+ *
IllegalArgumentException.
+ * @param messageIllegalArgument
+ * - Mensagem utiliada na exceção
+ * IllegalArgumentException.
+ *
+ * @throws IllegalArgumentException
+ *
+ * @since 0.2
+ */
+ public static void checkNotEmpty(Collection collection,
+ String messageNullPointer, String messageIllegalArgument) {
+
+ if (collection == null) {
+
+ Exceptions.throwIllegalArgumentException(messageNullPointer);
+ }
+
+ if (collection.isEmpty()) {
+
+ Exceptions.throwIllegalArgumentException(messageIllegalArgument);
+ }
+ }
+
+ /**
+ * Verifica se o mapa passado por parâmetro não é
+ * null ou se é vazio.
+ *
+ * Caso o objeto seja null, lança
+ * NullPointerException com a mensagem informada no parâmetro
+ * messageNullPointer (primeiro parâmetro String). Caso o
+ * objeto não seja null e não possua elementos, lança
+ * IllegalArgumentException com a mensagem informada no
+ * parâmetro messageIllegalArgument (segundo parâmetro String).
+ *
IllegalArgumentException.
+ * @param messageIllegalArgument
+ * - Mensagem utiliada na exceção
+ * IllegalArgumentException.
+ *
+ * @throws IllegalArgumentException
+ *
+ * @since 0.2
+ */
+ public static void checkNotEmpty(Map map, String messageNullPointer,
+ String messageIllegalArgument) {
+
+ if (map == null) {
+
+ Exceptions.throwIllegalArgumentException(messageNullPointer);
+ }
+
+ if (map.isEmpty()) {
+
+ Exceptions.throwIllegalArgumentException(messageIllegalArgument);
+ }
+ }
+
+}
diff --git a/src/br/com/nordestefomento/jrimum/utilix/DateUtil.java b/src/main/java/org/jrimum/utilix/Dates.java
similarity index 50%
rename from src/br/com/nordestefomento/jrimum/utilix/DateUtil.java
rename to src/main/java/org/jrimum/utilix/Dates.java
index fcd8880..114198f 100644
--- a/src/br/com/nordestefomento/jrimum/utilix/DateUtil.java
+++ b/src/main/java/org/jrimum/utilix/Dates.java
@@ -27,9 +27,9 @@
*
*/
-package br.com.nordestefomento.jrimum.utilix;
+package org.jrimum.utilix;
-import static br.com.nordestefomento.jrimum.utilix.ObjectUtil.isNotNull;
+import static org.jrimum.utilix.Objects.isNotNull;
import java.text.DateFormat;
import java.text.ParseException;
@@ -39,190 +39,215 @@
import org.apache.commons.lang.time.DateUtils;
-
/**
- *
- * Esta classe tem a responsabilidade de prover serviços utilitários
- * relacionados a manipulação de Objetos Date, Calendar, GregorianCalendar.
- *
- *
+ *
+ * Serviços utilitários relacionados a manipulação de Objetos
+ * Date, Calendar, GregorianCalendar.
+ *
+ * Representa uma data inexistente, pode ser usada em casos que não se pode
+ * usar null [ é obtida da seguinte forma:
+ * Calendar.set(1, 0, 1) ]
+ *
+ * Retorna uma data inexistente, pode ser usada em casos que não se pode
+ * usar null [ é obtida da seguinte forma:
+ * Calendar.set(1, 0, 1) ]
+ *
null.
- * - * É obtida da seguinte forma:
new GregorianCalendar(1, 0, 1).getTime()
+ * + * Compara uma dada data qualquer com a data invalida 01/01/0001. + *
+ * + * @param date - Data qualquer + * + * @return igualdade - Se igual a data inválida */ - public static final Date DATE_NULL; - - static { + public static boolean equalsInvalidDate(Date date){ - Calendar calendar = Calendar.getInstance(); - calendar.set(1, 0, 1); - calendar.setLenient(false); - DATE_NULL = DateUtils.truncate(calendar.getTime(), Calendar.YEAR); + if(date == null){ + + return false; + + }else{ + + return (DATE_NULL.compareTo(date) == 0); + } } /** *
- * Converte um objeto String em um objeto java.util.Date
- * no formato de data padrão brasileiro: dd/MM/yyyy.
- *
- * Utiliza a sobrecarca parse(String dateAsString, DateFormat dateFormat) para
- * realizar a conversão.
+ * Calcula a diferença de dias entre duas datas. O resultado é modular, ou
+ * seja, maior ou igual a zero, logo a data final não precisa ser
+ * necessariamente maior que a data inicial.
*
String.
- * @return Objeto java.util.Date convertido a partir do objeto String
+ * @param dataInicial
+ * - data inicial do intervalo.
+ * @param dataFinal
+ * - data final do intervalo.
+ * @return número(módulo) de dias entre as datas.
*
- * @throws IllegalArgumentException caso o objeto String não seja um valor válido
- * de data suportado pelo formato.
+ * @throws IllegalArgumentException
+ * Caso pelo menos uma das duas datas seja null.
+ * @since 0.2
*/
- public static Date parse(String dateAsString) {
+ public static long calculeDiferencaEmDias(final Date dataInicial, final Date dataFinal) {
+
+ long fator = 0;
- return parse(dateAsString, FORMAT_DD_MM_YYYY);
+ Date dataInicialTruncada, dataFinalTruncada;
+
+ if (isNotNull(dataInicial) && isNotNull(dataFinal)) {
+
+ dataInicialTruncada = DateUtils.truncate(dataInicial, Calendar.DATE);
+ dataFinalTruncada = DateUtils.truncate(dataFinal, Calendar.DATE);
+
+ fator = ((dataFinalTruncada.getTime() - dataInicialTruncada.getTime()) / DateUtils.MILLIS_PER_DAY);
+
+ if (fator < 0) {
+ fator *= -1;
+ }
+
+ } else {
+
+ Exceptions.throwIllegalArgumentException("A data inicial [" + dataInicial
+ + "] e a data final [" + dataFinal + "] "
+ + "não podem ter valor 'null'.");
+ }
+
+ return fator;
}
-
+
/**
*
- * Converte um objeto String em um objeto java.util.Date
- * a partir do formato de data especificado.
+ * Converte um objeto String em um objeto
+ * java.util.Date a partir do formato de data especificado.
*
- * Utiliza a sobrecarca parse(String dateAsString, DateFormat dateFormat) para
+ *
+ * Utiliza a sobrecarca
+ * parse(String dateAsString, String dateFormat) para
* realizar a conversão.
*
String.
- * @param dateFormat - formato de data
- * @return Objeto java.util.Date convertido a partir do objeto String
+ * @param dateAsString
+ * - um valor de data em forma de String.
+ * @param dateFormat
+ * - formato de data em forma de String.
+ * @return Objeto java.util.Date convertido a partir do objeto
+ * String
*
- * @throws IllegalArgumentException caso o objeto String não seja um valor válido
- * de data suportado pelo formato.
+ * @throws IllegalArgumentException
+ * caso o objeto String não seja um valor válido de
+ * data suportado pelo formato.
+ * @since 0.2
*/
public static Date parse(String dateAsString, String dateFormat) {
-
+
if (dateFormat == null) {
throw new NullPointerException("O formato da data não pode ter valor [null].");
}
-
+
return parse(dateAsString, new SimpleDateFormat(dateFormat));
}
-
+
/**
- * Converte um objeto String em um objeto java.util.Date
- * através do objeto java.text.DateFormat especificado.
+ *
+ * Converte um objeto String em um objeto
+ * java.util.Date através do objeto
+ * java.text.DateFormat especificado.
+ *
String.
- * @param dateFormat - formatador para objetos java.util.Date.
- * @return Objeto java.util.Date convertido a partir do objeto String
+ * @param dateAsString
+ * - um valor de data em forma de String.
+ * @param dateFormat
+ * - formatador para objetos java.util.Date.
+ * @return Objeto java.util.Date convertido a partir do objeto
+ * String
*
- * @throws IllegalArgumentException caso o objeto String não seja um valor válido
- * de data suportado pelo formatador.
+ * @throws IllegalArgumentException
+ * caso o objeto String não seja um valor válido de
+ * data suportado pelo formatador.
+ * @since 0.2
*/
public static Date parse(String dateAsString, DateFormat dateFormat) {
-
+
Date date = null;
-
+
if (dateAsString == null) {
throw new NullPointerException("A String a ser convertida não pode ter valor [null].");
}
-
+
if (dateFormat == null) {
throw new NullPointerException("O formatador não pode ter valor [null].");
}
-
+
try {
-
+
date = dateFormat.parse(dateAsString);
-
+
} catch (ParseException e) {
-
- String msg = "A String [" + dateAsString + "] deve ser uma data válida no formato";
+
+ String msg = "A String [" + dateAsString
+ + "] deve ser uma data válida no formato";
if (dateFormat instanceof SimpleDateFormat) {
SimpleDateFormat sdf = (SimpleDateFormat) dateFormat;
msg += " [" + sdf.toPattern() + "].";
-
+
} else {
msg += " especificado.";
}
-
+
IllegalArgumentException iae = new IllegalArgumentException(msg);
iae.initCause(e);
throw iae;
}
-
+
return date;
}
-
- /**
- * - * Calcula a diferença de dias entre duas datas. O resultado é modular, - * ou seja, maior ou igual a zero, logo a data final não precisa ser - * necessariamente maior que a data inicial. - *
- * - * @param dataInicial - data inicial do intervalo. - * @param dataFinal - data final do intervalo. - * @return número(módulo) de dias entre as datas. - * - * @throws IllegalArgumentException Caso pelo menos uma das duas datas sejanull.
- */
- public static long calculeDiferencaEmDias(final Date dataInicial, final Date dataFinal) {
-
- long fator = 0;
- Date dataInicialTruncada, dataFinalTruncada;
-
-
- if (isNotNull(dataInicial) && isNotNull(dataFinal)) {
-
- dataInicialTruncada = DateUtils.truncate(dataInicial, Calendar.DATE);
- dataFinalTruncada = DateUtils.truncate(dataFinal, Calendar.DATE);
-
- fator = ((dataFinalTruncada.getTime() - dataInicialTruncada.getTime()) / DateUtils.MILLIS_PER_DAY);
-
- if (fator < 0) {
- fator *= -1;
- }
- }
- else {
- throw new IllegalArgumentException("A data inicial [" + dataInicial + "] e a data final [" + dataFinal + "] " +
- "não podem ter valor 'null'.");
- }
-
- return fator;
- }
-
}
diff --git a/src/main/java/org/jrimum/utilix/Exceptions.java b/src/main/java/org/jrimum/utilix/Exceptions.java
new file mode 100644
index 0000000..0bf408f
--- /dev/null
+++ b/src/main/java/org/jrimum/utilix/Exceptions.java
@@ -0,0 +1,251 @@
+/*
+ * Copyright 2011 JRimum Project
+ *
+ * Licensed 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.
+ *
+ * Created at: 15/05/2011 - 17:54:00
+ *
+ * ================================================================================
+ *
+ * Direitos autorais 2011 JRimum Project
+ *
+ * Licenciado sob a Licença Apache, Versão 2.0 ("LICENÇA"); você não pode usar
+ * esse arquivo exceto em conformidade com a esta LICENÇA. Você pode obter uma
+ * cópia desta LICENÇA em http://www.apache.org/licenses/LICENSE-2.0 A menos que
+ * haja exigência legal ou acordo por escrito, a distribuição de software sob
+ * esta LICENÇA se dará “COMO ESTÁ”, SEM GARANTIAS OU CONDIÇÕES DE QUALQUER
+ * TIPO, sejam expressas ou tácitas. Veja a LICENÇA para a redação específica a
+ * reger permissões e limitações sob esta LICENÇA.
+ *
+ * Created at: 15/05/2011 - 17:54:00
+ *
+ */
+
+package org.jrimum.utilix;
+
+/**
+ * Classe utilitária para lançar exceções de modo ecapsulado.
+ *
+ * @author Gilmar P.S.L.
+ *
+ * @since 0.2
+ *
+ * @version 0.2
+ */
+public class Exceptions {
+
+ /**
+ * Utility class pattern: classe não instanciável
+ *
+ * @throws IllegalStateException
+ * Caso haja alguma tentativa de utilização deste construtor.
+ */
+ private Exceptions() {
+
+ throwIllegalStateException("Instanciação não permitida!");
+ }
+
+ /**
+ * Lança imediatamente uma {@linkplain IllegalArgumentException}.
+ *
+ * @param
- * Classe responsável pela execução do conjunto de testes do projeto Utilix
+ * Locales não disponíveis em java.util.Locale.
*
+ * Localização pt-BR. + *
+ */ + public static final java.util.Locale BRASIL = new java.util.Locale("pt", "BR"); + + /** + *+ * Utility class pattern: classe não instanciável + *
+ * + * @throws IllegalStateException + * Caso haja alguma tentativa de utilização deste construtor. */ + private Locales() { + + Exceptions.throwIllegalStateException("Instanciação não permitida!"); + } } diff --git a/src/main/java/org/jrimum/utilix/Objects.java b/src/main/java/org/jrimum/utilix/Objects.java new file mode 100644 index 0000000..6437909 --- /dev/null +++ b/src/main/java/org/jrimum/utilix/Objects.java @@ -0,0 +1,362 @@ +/* + * Copyright 2008 JRimum Project + * + * Licensed 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. + * + * Created at: 30/03/2008 - 18:02:40 + * + * ================================================================================ + * + * Direitos autorais 2008 JRimum Project + * + * Licenciado sob a Licença Apache, Versão 2.0 ("LICENÇA"); você não pode usar + * esse arquivo exceto em conformidade com a esta LICENÇA. Você pode obter uma + * cópia desta LICENÇA em http://www.apache.org/licenses/LICENSE-2.0 A menos que + * haja exigência legal ou acordo por escrito, a distribuição de software sob + * esta LICENÇA se dará “COMO ESTÁ”, SEM GARANTIAS OU CONDIÇÕES DE QUALQUER + * TIPO, sejam expressas ou tácitas. Veja a LICENÇA para a redação específica a + * reger permissões e limitações sob esta LICENÇA. + * + * Criado em: 30/03/2008 - 18:02:40 + * + */ + +package org.jrimum.utilix; + +import org.apache.commons.lang.builder.ToStringBuilder; + + +/** + * Classe utilitária para validações de objetos em geral, como verificações de + * objetos nulos, com e sem exceções. + * + *+ * Fornece métodos booleanos e métodos que verificam se o valor do objeto está + * de acordo com o desejado e, caso não estejam, lançam exceção. + *
+ * + * @author Gilmar P.S.L. + * @author Rômulo Augusto + * + * @since 0.2 + * + * @version 0.2 + */ +public final class Objects { + + /** + * Utility class pattern: classe não instanciável + * + * @throws IllegalStateException + * Caso haja alguma tentativa de utilização deste construtor. + */ + private Objects() { + + Exceptions.throwIllegalStateException("Instanciação não permitida!"); + } + + /** + * Verifica se o objeto passado por parâmetro é {@code null}. + * + * @param object + * - Objeto analisado + * + * @return (object == null) + * + * @since 0.2 + */ + public static boolean isNull(Object object) { + + return (object == null); + } + + /** + * Verifica se o objeto passado por parâmetro não é + * {@code null}. + *+ * É o mesmo que usar o método {@code isNull} da forma + * {@code !isNull(obj)}, porém de forma mais legível. + *
+ * + * @param object + * - Objeto analisado + * + * @return (object != null) + * + * @see #isNull(Object) + * + * @since 0.2 + */ + public static boolean isNotNull(Object object) { + + return (object != null); + } + + /** + * Verifica se existe uma referência ao objeto dado. + * + * @param object + * - Objeto analisado + * + * @return (object != null); + * + * @see #isNotNull(Object) + * + * @since 0.2 + */ + public static boolean exists(Object object) { + + return (object != null); + } + + /** + * Verifica a verdade de uma expressão e lança uma + * {@code IllegalArgumentException}, caso a expressão seja + * false. + * + * @param expression + * - Qualquer expressão booleana + * @throws IllegalArgumentException + * se {@code expression == false} + * + * @since 0.2 + */ + public static void checkArgument(boolean expression) { + + if (!expression) { + Exceptions.throwIllegalArgumentException(); + } + } + + /** + * Verifica a verdade de uma expressão e lança uma + * {@code IllegalArgumentException}, com a mensagem iformada, caso a + * expressão seja false. + * + * @param expression + * - Qualquer expressão booleana + * @param message + * - Mensagem utilizada na exceção + * @throws IllegalArgumentException + * se {@code expression == false} + * + * @since 0.2 + */ + public static void checkArgument(boolean expression, String message) { + + if (!expression) { + Exceptions.throwIllegalArgumentException(message); + } + } + + /** + * Verifica a verdade de uma expressão e lança uma + * {@code IllegalStateException}, caso a expressão seja + * false. + * + * @param expression + * - Qualquer expressão booleana + * @throws IllegalStateException + * se {@code expression == false} + * + * @since 0.2 + */ + public static void checkState(boolean expression) { + + if (!expression) { + Exceptions.throwIllegalStateException(); + } + } + + /** + * Verifica a verdade de uma expressão e lança uma + * {@code IllegalStateException}, com a mensagem iformada, caso a + * expressão seja false. + * + * @param expression + * - Qualquer expressão booleana + * @param message + * - Mensagem utilizada na exceção + * @throws IllegalStateException + * se {@code expression == false} + * + * @since 0.2 + */ + public static void checkState(boolean expression, String message) { + + if (!expression) { + Exceptions.throwIllegalStateException(message); + } + } + + /** + * Verifica se o objeto é nulo e lança {@code IllegalArgumentException} + * , com a mensagem informada, caso não seja. + * + * @throws IllegalArgumentException - Caso o objeto não seja + * {@code null}. + * + * @see #isNull(Object) + * @see #isNotNull(Object) + * + * @since 0.2 + * + * @param object + * - Objeto analisado + * @param message + * - Mensagem utilizada na exceção + */ + public static void checkNull(Object object, String message) { + + if (object != null) { + + Exceptions.throwIllegalArgumentException(message); + } + } + + /** + * Verifica se o objeto é nulo e lança {@code IllegalArgumentException} + * caso não seja. + * + * @param object + * - Objeto analisado + * + * @throws IllegalArgumentException - Caso o objeto não seja + * {@code null}. + * + * @see #checkNull(Object, String) + * @see #isNull(Object) + * @see #isNotNull(Object) + * + * @since 0.2 + */ + public static void checkNull(Object object) { + + checkNull(object, new StringBuilder("Objeto não nulo! Valor [ ") + .append(object).append(" ].").toString()); + } + + /** + * Verifica se o objeto não é nulo e lança + * {@code IllegalArgumentException}, com a mensagem informada, caso + * seja. + * + * @param object + * - Objeto analisado + * @param message + * - Mensagem utilizada na exceção + * + * @throws IllegalArgumentException - Caso o objeto seja {@code null}. + * + * @see #isNull(Object) + * @see #isNotNull(Object) + * + * @since 0.2 + */ + public static void checkNotNull(Object object, String message) { + + if (object == null) { + + Exceptions.throwIllegalArgumentException(message); + } + } + + /** + * Verifica se o objeto não é nulo e lança + * {@code IllegalArgumentException} caso seja. + * + * @param object + * - Objeto analisado + * + * @throws IllegalArgumentException - Caso o objeto seja {@code null}. + * + * @see #checkNotNull(Object, String) + * @see #isNull(Object) + * @see #isNotNull(Object) + * + * @since 0.2 + */ + public static void checkNotNull(Object object) { + + checkNotNull(object, "Objeto nulo!"); + } + + /** + * Retorna um dado valor padrão quando o determinado objeto for nulo. + * + *
+ * whenNull(null, null) = null
+ * whenNull(null, "") = ""
+ * whenNull(null, "ex") = "ex"
+ * whenNull("abc", *) = "abc"
+ * whenNull(Boolean.TRUE, *) = Boolean.TRUE
+ *
+ *
+ * @param
+ * whenNull(null, null, null) = null
+ * whenNull(null, "1", "2") = "1"
+ * whenNull("ok", "1", "2") = "2"
+ *
+ *
+ * @param + * Formatadores de data thread-safe. Para uma mesma categoria, os formatadores + * atualmente são diferenciados pelos seus separadores ("formato_separador") + * exemplos: + *
-
+ *
- DDMMYY
default:ddMMyy
+ * - DDMMYY_B
barr:dd/MM/yy
+ * - DDMMYY_H
hyphen:dd-MM-yy
+ * - DDMMYY_U
underline:dd_MM_yy
+ * - HHMMSS_C
colon:"hh:mm:ss"
+ * - etc. + *
+ * Formatador de datas no padrão "ddMMyy". + *
+ */ + DDMMYY("ddMMyy"), + + /** + *+ * Formatador de datas no padrão "dd/MM/yy". + *
+ */ + DDMMYY_B("dd/MM/yy"), + + /** + *+ * Formatador de datas no padrão "dd-MM-yy". + *
+ */ + DDMMYY_H("dd-MM-yy"), + + /** + *+ * Formatador de datas no padrão "dd_MM_yy". + *
+ */ + DDMMYY_U("dd_MM_yy"), + + /** + *+ * Formatador de datas no padrão "ddMMyyyy". + *
+ */ + DDMMYYYY("ddMMyyyy"), + + /** + *+ * Formatador de datas no padrão "dd/MM/yyyy". + *
+ */ + DDMMYYYY_B("dd/MM/yyyy"), + + /** + *+ * Formatador de datas no padrão "dd-MM-yyyy". + *
+ */ + DDMMYYYY_H("dd-MM-yyyy"), + + /** + *+ * Formatador de datas no padrão "dd_MM_yyyy". + *
+ */ + DDMMYYYY_U("dd_MM_yyyy"), + + /** + *+ * Formatador de datas no padrão "yyMMdd". + *
+ */ + YYMMDD("yyMMdd"), + + /** + *+ * Formatador de datas no padrão "yy/MM/dd". + *
+ */ + YYMMDD_B("yy/MM/dd"), + + /** + *+ * Formatador de datas no padrão "yy/MM/dd". + *
+ */ + YYMMDD_H("yy-MM-dd"), + + /** + *+ * Formatador de datas no padrão "yy_MM_dd". + *
+ */ + YYMMDD_U("yy_MM_dd"), + + /** + *+ * Formatador de datas no padrão "yyyyMMdd". + *
+ */ + YYYYMMDD("yyyyMMdd"), + + /** + *+ * Formatador de datas no padrão "yyyy/MM/dd". + *
+ */ + YYYYMMDD_B("yyyy/MM/dd"), + + /** + *+ * Formatador de datas no padrão "yyyy-MM-dd". + *
+ */ + YYYYMMDD_H("yyyy-MM-dd"), + + /** + *+ * Formatador de datas no padrão "yyyy_MM_dd". + *
+ */ + YYYYMMDD_U("yyyy_MM_dd"), + + /** + *+ * Formatador de datas no padrão "hhmmss". + *
+ */ + HHMMSS("hhmmss"), + + /** + *+ * Formatador de datas no padrão "HHmmss". + *
+ */ + HHMMSS_24("HHmmss"), + + /** + *+ * Formatador de datas no padrão "hh:mm:ss". + *
+ */ + HHMMSS_C("hh:mm:ss"), + + /** + *+ * Formatador de datas no padrão "HH:mm:ss". + *
+ */ + HHMMSS_24C("HH:mm:ss"), + ; + + private final ThreadLocalFormat+ * Formatadores thread-safe relacionados a moeda e números decimais. + *
+ * + * @author Gilmar P.S.L. + * + * @since 0.2 + * + * @version 0.2 + */ +public enum DecimalFormat implements Format
+ * Formatador de decimais pt-BR para Float,Double,BigDecimal no padrão
+ * "#,##0.0". Exemplo: "1.500,9".
+ *
+ * Formatador de decimais pt-BR para Float,Double,BigDecimal no padrão
+ * "#,##0.00". Exemplo: "1.500,99".
+ *
+ * Formatador de decimais Float,Double,BigDecimal no padrão de
+ * moeda (Real pt-BR): "R$ #,##0.0". Usado para formatar valores
+ * monetários em real com o prefixo R$, exemplo: R$ 10,0.
+ *
+ * Formatador de decimais Float,Double,BigDecimal no padrão de
+ * moeda (Real pt-BR): "R$ #,##0.00". Usado para formatar valores
+ * monetários em real com o prefixo R$, exemplo: R$ 10,00.
+ *
+ * DecimalFormatSymbols com localização (Processo de localização) inicialmente + * do Brasil. + *
+ * + * @author Gilmar P.S.L. + * + * @since 0.2 + * + * @version 0.2 + */ +public enum DecimalFormatSymbols { + + /** + * DecimalFormatSymbols relacionados aos padrões pt-BR. + */ + BRASIL; + + private final ThreadLocal
+ * Cópia de símbolos utilizados em BRASIL.
+ *
java.text.DecimalFormatSymbols estilo pt-BR
+ *
+ * @since 0.2
+ */
+ public java.text.DecimalFormatSymbols copy() {
+
+ return (java.text.DecimalFormatSymbols) DF_SYMBOLS.get().clone();
+ }
+}
diff --git a/src/main/java/org/jrimum/utilix/text/Format.java b/src/main/java/org/jrimum/utilix/text/Format.java
new file mode 100644
index 0000000..7e53c50
--- /dev/null
+++ b/src/main/java/org/jrimum/utilix/text/Format.java
@@ -0,0 +1,76 @@
+/*
+ * Copyright 2010 JRimum Project
+ *
+ * Licensed 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.
+ *
+ * Created at: 01/08/2010 - 17:31:00
+ *
+ * ================================================================================
+ *
+ * Direitos autorais 2010 JRimum Project
+ *
+ * Licenciado sob a Licença Apache, Versão 2.0 ("LICENÇA"); você não pode usar
+ * esse arquivo exceto em conformidade com a esta LICENÇA. Você pode obter uma
+ * cópia desta LICENÇA em http://www.apache.org/licenses/LICENSE-2.0 A menos que
+ * haja exigência legal ou acordo por escrito, a distribuição de software sob
+ * esta LICENÇA se dará “COMO ESTÁ”, SEM GARANTIAS OU CONDIÇÕES DE QUALQUER
+ * TIPO, sejam expressas ou tácitas. Veja a LICENÇA para a redação específica a
+ * reger permissões e limitações sob esta LICENÇA.
+ *
+ * Criado em: 01/08/2010 - 17:31:00
+ *
+ */
+
+package org.jrimum.utilix.text;
+
+/**
+ * + * Interface usada para objetos formatadores utilizados em leitura e escrita de + * textos. + *
+ * + * @author Gilmar P.S.L + * + * @since 0.2 + * + * @version 0.2 + */ +public interface Format+ * Formata um dado objeto para uma representação em string. + *
+ * + * @param obj + * - Objeto a ser formatado. + * @return string - String formatada. + */ + String format(T obj); + + /** + *+ * Transforma uma string formatada em um objeto correspondente. + *
+ * + * @param text + * - Texto a ser analisado e transformado em objeto. + * @return objeto - Resultado da transformação da string. + */ + T parse(String text); + + /** + *+ * Devolve uma cópia do formatador utilizado pela instância. + *
+ * + * @return formatador - Cópia da instância do formatador. + */ + F copy(); +} diff --git a/src/main/java/org/jrimum/utilix/text/Strings.java b/src/main/java/org/jrimum/utilix/text/Strings.java new file mode 100644 index 0000000..05bc70c --- /dev/null +++ b/src/main/java/org/jrimum/utilix/text/Strings.java @@ -0,0 +1,516 @@ +/* + * Copyright 2008 JRimum Project + * + * Licensed 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. + * + * Created at: 30/03/2008 - 18:18:19 + * + * ================================================================================ + * + * Direitos autorais 2008 JRimum Project + * + * Licenciado sob a Licença Apache, Versão 2.0 ("LICENÇA"); você não pode usar + * esse arquivo exceto em conformidade com a esta LICENÇA. Você pode obter uma + * cópia desta LICENÇA em http://www.apache.org/licenses/LICENSE-2.0 A menos que + * haja exigência legal ou acordo por escrito, a distribuição de software sob + * esta LICENÇA se dará “COMO ESTÁ”, SEM GARANTIAS OU CONDIÇÕES DE QUALQUER + * TIPO, sejam expressas ou tácitas. Veja a LICENÇA para a redação específica a + * reger permissões e limitações sob esta LICENÇA. + * + * Criado em: 30/03/2008 - 18:18:19 + * + */ + +package org.jrimum.utilix.text; + +import static java.lang.String.format; +import static org.apache.commons.lang.StringUtils.EMPTY; +import static org.apache.commons.lang.StringUtils.isBlank; +import static org.apache.commons.lang.StringUtils.isNotBlank; +import static org.apache.commons.lang.StringUtils.isNumeric; +import static org.apache.commons.lang.StringUtils.leftPad; +import static org.apache.commons.lang.StringUtils.removeStart; +import static org.apache.commons.lang.StringUtils.replace; +import static org.apache.commons.lang.StringUtils.replaceChars; +import static org.apache.commons.lang.StringUtils.startsWith; +import static org.jrimum.utilix.Objects.isNotNull; + +import org.apache.commons.lang.StringUtils; +import org.jrimum.utilix.Exceptions; +import org.jrimum.utilix.Objects; + +/** + * Esta classe tem a responsabilidade de prover serviços utilitários + * relacionados a manipulação deStrings
+ *
+ * @author Gilmar P.S.L
+ * @author Misael Barreto
+ * @author Rômulo Augusto
+ * @author Nordeste Fomento
+ * Mercantil
+ *
+ * @since 0.2
+ *
+ * @version 0.2
+ */
+public final class Strings {
+
+ public static final String WHITE_SPACE = " ";
+
+ /**
+ * Utility class pattern: classe não instanciável
+ *
+ * @throws AssertionError
+ * caso haja alguma tentativa de utilização deste construtor.
+ */
+ private Strings() {
+
+ Exceptions.throwIllegalStateException("Instanciação não permitida!");
+ }
+
+ /**
+ * Elimina simbolos como:
+ *
+ * > + * <,;.:!*&%+-_<>[]\/ + *+ * + * @param str + * String com os símbolos a serem removidos. + * @return String sem símbolos. + * @since 0.2 + */ + public static String eliminateSymbols(final String str) { + + String modifiedStr = str; + + if (isNotBlank(modifiedStr)) { + + modifiedStr = replace(modifiedStr, "-", EMPTY); + modifiedStr = replace(modifiedStr, "_", EMPTY); + modifiedStr = replace(modifiedStr, "=", EMPTY); + modifiedStr = replace(modifiedStr, "+", EMPTY); + modifiedStr = replace(modifiedStr, "%", EMPTY); + modifiedStr = replace(modifiedStr, "*", EMPTY); + modifiedStr = replace(modifiedStr, "@", EMPTY); + modifiedStr = replace(modifiedStr, "#", EMPTY); + modifiedStr = replace(modifiedStr, "&", EMPTY); + modifiedStr = replace(modifiedStr, ":", EMPTY); + modifiedStr = replace(modifiedStr, ".", EMPTY); + modifiedStr = replace(modifiedStr, ";", EMPTY); + modifiedStr = replace(modifiedStr, ",", EMPTY); + modifiedStr = replace(modifiedStr, "!", EMPTY); + modifiedStr = replace(modifiedStr, "?", EMPTY); + modifiedStr = replace(modifiedStr, "(", EMPTY); + modifiedStr = replace(modifiedStr, ")", EMPTY); + modifiedStr = replace(modifiedStr, "{", EMPTY); + modifiedStr = replace(modifiedStr, "}", EMPTY); + modifiedStr = replace(modifiedStr, "[", EMPTY); + modifiedStr = replace(modifiedStr, "]", EMPTY); + modifiedStr = replace(modifiedStr, "/", EMPTY); + modifiedStr = replace(modifiedStr, "\\", EMPTY); + modifiedStr = replace(modifiedStr, ">", EMPTY); + modifiedStr = replace(modifiedStr, "<", EMPTY); + modifiedStr = replace(modifiedStr, "\"", EMPTY); + modifiedStr = replace(modifiedStr, "'", EMPTY); + modifiedStr = replace(modifiedStr, "`", EMPTY); + } + + return modifiedStr; + } + + /** + * Remove os zeros iniciais de uma
String, seja ela numérica ou
+ * não.
+ *
+ * removeStartWithZeros("00000") => 0
+ * removeStartWithZeros("00023") => 23
+ * removeStartWithZeros("02003") => 2003
+ *
+ * + * @param str + * @return a string sem zeros inicias ou um único zero. + * + * @since 0.2 + */ + + public static String removeStartWithZeros(final String str) { + + String withoutZeros = EMPTY; + final String zero = "0"; + + if (isNotNull(str)) { + + if (startsWith(str, zero)) { + + withoutZeros = removeStart(str, zero); + + while (startsWith(withoutZeros, zero)) { + withoutZeros = removeStart(withoutZeros, zero); + } + + if (withoutZeros.trim().length() == 0) { + withoutZeros = zero; + } + + } else { + withoutZeros = str; + } + } + + return withoutZeros; + } + + /** + * Remove a acentuação do texto, que inclui os acentos: + *
-
+ *
- Agudo. ex.: á + *
- Grave. ex.: à + *
- Til. ex.: ã + *
- Trema. ex.: ä + *
- Circunflexo. ex.: â + *
+ * Os acentos são removidos tanto para letras minúsculas como para letras + * maiúsculas. + *
+ * + * @param value + * String com os caracteres a serem removidos. + * @return String sem acentuação. + * @since 0.2 + */ + public static String eliminateAccent(final String value) { + + String modifiedValue = value; + + // Para ç e Ç + modifiedValue = replaceChars(modifiedValue, '\u00E7', 'c'); + modifiedValue = replaceChars(modifiedValue, '\u00C7', 'C'); + + // Para à, á, â, ã e ä + modifiedValue = replaceChars(modifiedValue, '\u00E0', 'a'); + modifiedValue = replaceChars(modifiedValue, '\u00E1', 'a'); + modifiedValue = replaceChars(modifiedValue, '\u00E2', 'a'); + modifiedValue = replaceChars(modifiedValue, '\u00E3', 'a'); + modifiedValue = replaceChars(modifiedValue, '\u00E4', 'a'); + + // Para è, é, ê e ë + modifiedValue = replaceChars(modifiedValue, '\u00E8', 'e'); + modifiedValue = replaceChars(modifiedValue, '\u00E9', 'e'); + modifiedValue = replaceChars(modifiedValue, '\u00EA', 'e'); + modifiedValue = replaceChars(modifiedValue, '\u00EB', 'e'); + + // Para ì, í, î e ï + modifiedValue = replaceChars(modifiedValue, '\u00EC', 'i'); + modifiedValue = replaceChars(modifiedValue, '\u00ED', 'i'); + modifiedValue = replaceChars(modifiedValue, '\u00EE', 'i'); + modifiedValue = replaceChars(modifiedValue, '\u00EF', 'i'); + + // Para ò, ó, ô, õ e ö + modifiedValue = replaceChars(modifiedValue, '\u00F2', 'o'); + modifiedValue = replaceChars(modifiedValue, '\u00F3', 'o'); + modifiedValue = replaceChars(modifiedValue, '\u00F4', 'o'); + modifiedValue = replaceChars(modifiedValue, '\u00F5', 'o'); + modifiedValue = replaceChars(modifiedValue, '\u00F6', 'o'); + + // Para ù, ú, û e ü + modifiedValue = replaceChars(modifiedValue, '\u00F9', 'u'); + modifiedValue = replaceChars(modifiedValue, '\u00FA', 'u'); + modifiedValue = replaceChars(modifiedValue, '\u00FB', 'u'); + modifiedValue = replaceChars(modifiedValue, '\u00FC', 'u'); + + // Para À, Á, Â, Ã e Ä + modifiedValue = replaceChars(modifiedValue, '\u00C0', 'A'); + modifiedValue = replaceChars(modifiedValue, '\u00C1', 'A'); + modifiedValue = replaceChars(modifiedValue, '\u00C2', 'A'); + modifiedValue = replaceChars(modifiedValue, '\u00C3', 'A'); + modifiedValue = replaceChars(modifiedValue, '\u00C4', 'A'); + + // Para È, É, Ê e Ë + modifiedValue = replaceChars(modifiedValue, '\u00C8', 'E'); + modifiedValue = replaceChars(modifiedValue, '\u00C9', 'E'); + modifiedValue = replaceChars(modifiedValue, '\u00CA', 'E'); + modifiedValue = replaceChars(modifiedValue, '\u00CB', 'E'); + + // Para Ì, Í, Î e Ï + modifiedValue = replaceChars(modifiedValue, '\u00CC', 'I'); + modifiedValue = replaceChars(modifiedValue, '\u00CD', 'I'); + modifiedValue = replaceChars(modifiedValue, '\u00CE', 'I'); + modifiedValue = replaceChars(modifiedValue, '\u00CF', 'I'); + + // Para Ò, Ó, Ô, Õ e Ö + modifiedValue = replaceChars(modifiedValue, '\u00D2', 'O'); + modifiedValue = replaceChars(modifiedValue, '\u00D3', 'O'); + modifiedValue = replaceChars(modifiedValue, '\u00D4', 'O'); + modifiedValue = replaceChars(modifiedValue, '\u00D5', 'O'); + modifiedValue = replaceChars(modifiedValue, '\u00D6', 'O'); + + // Para Ù, Ú, Û e Ü + modifiedValue = replaceChars(modifiedValue, '\u00D9', 'U'); + modifiedValue = replaceChars(modifiedValue, '\u00DA', 'U'); + modifiedValue = replaceChars(modifiedValue, '\u00DB', 'U'); + modifiedValue = replaceChars(modifiedValue, '\u00DC', 'U'); + + return modifiedValue; + } + + /** + * Verifica se aString passada por parâmetro não é
+ * null e não é numérica, ou seja, se a string não contém
+ * somente dígitos unicode.
+ * + * Lança exceção, com a mensagem passada por parâmetro (segundo parâmetro + * String), caso não preencha estes requisitos. + *
+ * + * @param value + * - String analisada + * + * @param message + * - Mensagem utiliada na exceção. + * + * @throws IllegalArgumentException - Caso a string sejanull ou
+ * caso a string não seja numérica.
+ *
+ * @since 0.2
+ */
+ public static void checkNotNumeric(String value, String message) {
+
+ checkNotNumeric(value, message, message);
+ }
+
+ /**
+ * Verifica se a String passada por parâmetro não é
+ * null e não é numérica, ou seja, se a string não contém
+ * somente dígitos unicode.
+ * + * Lança exceção, com a mensagem passada por parâmetro (segundo parâmetro + * String), caso não preencha estes requisitos. + *
+ * + * @param value + * - String analisada + * + * @throws IllegalArgumentException - Caso a string sejanull ou
+ * caso a string não seja numérica.
+ *
+ * @since 0.2
+ */
+ public static void checkNotNumeric(String value) {
+
+ checkNotNumeric(value, "String nula!", format(
+ "Valor inválido. String [\"%s\"] não numérica!", value));
+ }
+
+ /**
+ * Verifica se a String passada por parâmetro não é
+ * null, não é vazia (EMPTY) e não possui apenas
+ * espaços em branco.
+ * + * Lança exceção, com a mensagem passada por parâmetro (segundo parâmetro + * String), caso não preencha estes requisitos. + *
+ * + * @param value + * - String analisada + * + * @param message + * - Mensagem utiliada na exceção. + * + * @throws IllegalArgumentException - Caso a string sejanull ou
+ * caso a string seja vazia.
+ *
+ * @since 0.2
+ */
+ public static void checkNotBlank(String value, String message) {
+
+ checkNotBlank(value, message, message);
+ }
+
+ /**
+ * Verifica se a String passada por parâmetro não é
+ * null, não é vazia (EMPTY) e não possui apenas
+ * espaços em branco. Lança exceção caso não preencha estes requisitos.
+ *
+ * @param value
+ * - String analisada
+ *
+ * @throws IllegalArgumentException - Caso a string seja null ou
+ * caso a string seja vazia.
+ *
+ * @since 0.2
+ */
+ public static void checkNotBlank(String value) {
+
+ checkNotBlank(
+ value,
+ "String nula!",
+ format(
+ "Valor inválido. String [\"%s\"] vazia ou contendo somente espaços em branco!",
+ value));
+ }
+
+ /**
+ * Retorna uma dado valor padrão quando a string informada for considerada
+ * como blank por {@linkplain StringUtils#isBlank(String)}.
+ *
+ *
+ * whenBlank(null, null) = null
+ * whenBlank(null, "") = ""
+ * whenBlank("", "") = ""
+ * whenBlank("", "a") = "a"
+ * whenBlank(" ", "ex") = "ex"
+ * whenBlank("abc", *) = "abc"
+ *
+ *
+ * @param str
+ * String a testar e ser usada como valor de retorno se não for
+ * blank, pode ser null
+ * @param defaultValue
+ * - O valor padrão retornado caso a string testada seja blank,
+ * pode ser null
+ * @return String - Se não for blank, caso contrário
+ * defaultValue
+ *
+ * @since 0.2
+ */
+ public static String whenBlank(String str, String defaultValue) {
+
+ return (isNotBlank(str) ? str : defaultValue);
+ }
+
+ /**
+ * Método privado para fins de reutilização de código.
+ *
+ * Verifica se a String passada por parâmetro não é
+ * null e não é numérica, ou seja, se a string não contém
+ * somente dígitos unicode.
+ *
+ * Lança IllegalArgumentException, com a mensagem definida em
+ * messageNullPointer (segundo parâmetro String), caso o valor
+ * passado seja null
+ *
+ * Lança IllegalArgumentException, com a mensagem definida em
+ * messageIllegalArgument (terceiro parâmetro String), caso o
+ * valor passado não seja numérico.
+ *
null ou
+ * caso a string não seja numérica.
+ *
+ * @since 0.2
+ */
+ private static void checkNotNumeric(String value,
+ String messageNullPointer, String messageIllegalArgument) {
+
+ Objects.checkNotNull(value, messageNullPointer);
+
+ if (!isNumeric(value)) {
+ Exceptions.throwIllegalArgumentException(messageIllegalArgument);
+ }
+ }
+
+ /**
+ * Método privado para fins de reutilização de código.
+ *
+ * Verifica se a String passada por parâmetro não é
+ * null, não é vazia (StringUtils.EMPTY) e não
+ * possui apenas espaços em branco.
+ *
+ * Lança IllegalArgumentException, com a mensagem definida em
+ * messageNullPointer (segundo parâmetro String), caso o valor
+ * passado seja null
+ *
+ * Lança IllegalArgumentException, com a mensagem definida em
+ * messageIllegalArgument (terceiro parâmetro String), caso o
+ * valor passado seja vazio.
+ *
null ou
+ * caso a string seja vazia.
+ *
+ * @since 0.2
+ */
+ private static void checkNotBlank(String value, String messageNullPointer,
+ String messageIllegalArgument) {
+
+ Objects.checkNotNull(value, messageNullPointer);
+
+ if (isBlank(value)) {
+ Exceptions.throwIllegalArgumentException(messageIllegalArgument);
+ }
+ }
+
+ /**
+ * Retorna uma string de tamanho informado {@code length} com o
+ * preenchimento de zeros à esquerda para o número informado.
+ *
+ * @param numberToFill
+ * Número a ser transformado em string com zeros à esquerda
+ * @param length
+ * Tamanho final da string com zeros à esquerda
+ * @return string com zeros a esquerda
+ */
+ public static String fillWithZeroLeft(int numberToFill, int length){
+ return fillWithZeroLeft(String.valueOf(numberToFill), length);
+ }
+
+ /**
+ * Retorna uma string de tamanho informado {@code length} com o
+ * preenchimento de zeros à esquerda para o número informado.
+ *
+ * @param numberToFill
+ * Número a ser transformado em string com zeros à esquerda
+ * @param length
+ * Tamanho final da string com zeros à esquerda
+ * @return string com zeros a esquerda
+ */
+ public static String fillWithZeroLeft(long numberToFill, int length){
+ return fillWithZeroLeft(String.valueOf(numberToFill), length);
+ }
+
+ /**
+ * Retorna uma string de tamanho informado {@code length} com o
+ * preenchimento de zeros à esquerda para a string informada.
+ *
+ * @param stringToFill
+ * String a ser preenchida com zeros à esquerda
+ * @param length
+ * Tamanho final da string com zeros à esquerda
+ * @return string com zeros a esquerda
+ */
+ public static String fillWithZeroLeft(String stringToFill, int length){
+ return leftPad(stringToFill, length, "0");
+ }
+}
diff --git a/src/main/java/org/jrimum/utilix/text/ThreadLocalFormat.java b/src/main/java/org/jrimum/utilix/text/ThreadLocalFormat.java
new file mode 100644
index 0000000..d67e276
--- /dev/null
+++ b/src/main/java/org/jrimum/utilix/text/ThreadLocalFormat.java
@@ -0,0 +1,55 @@
+/*
+ * Copyright 2010 JRimum Project
+ *
+ * Licensed 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.
+ *
+ * Created at: 01/08/2010 - 17:31:00
+ *
+ * ================================================================================
+ *
+ * Direitos autorais 2010 JRimum Project
+ *
+ * Licenciado sob a Licença Apache, Versão 2.0 ("LICENÇA"); você não pode usar
+ * esse arquivo exceto em conformidade com a esta LICENÇA. Você pode obter uma
+ * cópia desta LICENÇA em http://www.apache.org/licenses/LICENSE-2.0 A menos que
+ * haja exigência legal ou acordo por escrito, a distribuição de software sob
+ * esta LICENÇA se dará “COMO ESTÁ”, SEM GARANTIAS OU CONDIÇÕES DE QUALQUER
+ * TIPO, sejam expressas ou tácitas. Veja a LICENÇA para a redação específica a
+ * reger permissões e limitações sob esta LICENÇA.
+ *
+ * Criado em: 01/08/2010 - 17:31:00
+ *
+ */
+
+package org.jrimum.utilix.text;
+
+import org.jrimum.utilix.Objects;
+
+/**
+ * + * Abstração para o uso de formatadores thread-safe em enumerações. + *
+ * + * @author Gilmar P.S.L. + * + * @since 0.2 + * + * @version 0.2 + */ +public abstract class ThreadLocalFormat+ * Abstração para o uso de formatadores thread-safe com o uso de "localização" + * em enumerações. + *
+ * + * @author Gilmar P.S.L. + * + * @since 0.2 + * + * @version 0.2 + */ +public abstract class ThreadLocalLocalizedFormat+ * Teste unitário para a classe utilitária de coleções. + *
+ * + * @author Gilmar P.S.L. + * @author Rômulo Augusto + * + * @since 0.2 + * + * @version 0.2 + */ +public class TestCollections { + + private static final Object EMPTY_OBJECT = new Object(); + + private static final Map