MeasureRuler - Histórico de revisão

Rodrigogml: /* Utilização da Régua */

2021-11-23T14:53:25Z

Utilização da Régua

← Edição anterior		Edição das 14h53min de 23 de novembro de 2021
Linha 85:		Linha 85:

	Para realizar a conversão das unidades de medidas, utilizando ou não a régua de equivalências e/ou unidades de medidas pesonalizadas, devemos focar nos métodos '''.convertTo(...)''' da classe '''MeasureRuler'''. Há métodos simples utilizados para conversão dentro da mesma dimensão (sem utilização de equivalências) até métodos completos com a entrada de equivalências e definição da precisão de casas decimais.		Para realizar a conversão das unidades de medidas, utilizando ou não a régua de equivalências e/ou unidades de medidas pesonalizadas, devemos focar nos métodos '''.convertTo(...)''' da classe '''MeasureRuler'''. Há métodos simples utilizados para conversão dentro da mesma dimensão (sem utilização de equivalências) até métodos completos com a entrada de equivalências e definição da precisão de casas decimais.


			= Validação da MeasureRulerEquivalenceInterface =

			A classe '''MeasureRuller''' contém um método de validação para garantir que as informações da Hash de equivalências não estão redundantes ou incoerentes.

Rodrigogml: /* Unidades de Medidas Personalizadas */

2021-11-23T14:33:15Z

Unidades de Medidas Personalizadas

← Edição anterior		Edição das 14h33min de 23 de novembro de 2021
Linha 56:		Linha 56:
	O MeasureRuler permite que o usuário crie suas próprias unidades de medidas bastando apenas definir um nome e um símbolo. Em uma classe que estenda a interface '''MeasureUnit'''. Para que a unidade de medida se torne funcional será ainda necessário estabelecer uma régua de equivalências, explicado no tópico de utilização.		O MeasureRuler permite que o usuário crie suas próprias unidades de medidas bastando apenas definir um nome e um símbolo. Em uma classe que estenda a interface '''MeasureUnit'''. Para que a unidade de medida se torne funcional será ainda necessário estabelecer uma régua de equivalências, explicado no tópico de utilização.

	{{note\|Persistência de Unidades de Medidas Personalizadas\|Vale ressaltar que as unidades de medidas personalizadas não podem ser persistidas com o MeasureUnitDAOConverter. Esses objetos devem ser persistidos em atributos separados como um objeto do sistema, ou o desenvolvedor deve implementar seu próprio converter para o determinado atributo.}}

			{{nota\|Persistência de Unidades de Medidas Personalizadas\|Vale ressaltar que as unidades de medidas personalizadas não podem ser persistidas com o MeasureUnitDAOConverter. Esses objetos devem ser persistidos em atributos separados como um objeto do sistema, ou o desenvolvedor deve implementar seu próprio converter para o determinado atributo.}}

	= Estabelecendo Paridade de Conversão - MeasureRulerEquivalenceIntercade =		= Estabelecendo Paridade de Conversão - MeasureRulerEquivalenceIntercade =

Rodrigogml: /* Estabelecendo Paridade de Conversão - MeasureRulerEquivalenceIntercade */

2021-11-23T14:14:25Z

Estabelecendo Paridade de Conversão - MeasureRulerEquivalenceIntercade

← Edição anterior		Edição das 14h14min de 23 de novembro de 2021
Linha 71:		Linha 71:

	{{stop\|Informações Redundantes\|Só devemos ter uma unidade de medida de cada dimensão. Incluir na Hash múltiplas informações da mesma dimensão é desnecessário, e podem resultar em resultados "aleatórios" se elas não forem coerentes.		{{stop\|Informações Redundantes\|Só devemos ter uma unidade de medida de cada dimensão. Incluir na Hash múltiplas informações da mesma dimensão é desnecessário, e podem resultar em resultados "aleatórios" se elas não forem coerentes.
	~~Exemplo~~:		Exemplos:

	'''Incluir 1Kg, 1000g e 50Unidades''' - A hash aceitará a unidade de medida KILOGRAM e GRAM, mas a informação é redundante, mas não causará nenhum problema.		'''Incluir 1Kg, 1000g e 50Unidades''' - A hash aceitará a unidade de medida KILOGRAM e GRAM, mas a informação é redundante, mas não causará nenhum problema.
	'''Incluir 1Kg, 500g e 50Unidades''' - Informar que 1Kg é equivalente à 500g é uma informação incoerente. Ao procurar as equivalências para converter Unidades em Massa, o MeasureRuler pode hora utilizar a informação de 1Kg = 50 Unidades, hora utilizar 500g = 50Unidades. Dependendo da informação que encontrar primeiro na Hash o resultado será diferente.
			'''Incluir 1Kg, 500g e 50Unidades''' - Informar que 1Kg é equivalente à 500g é uma informação incoerente. Ao procurar as equivalências para converter Unidades em Massa, o MeasureRuler pode hora utilizar a informação de 1Kg - 50 Unidades, hora utilizar 500g - 50Unidades. Dependendo da informação que encontrar primeiro na Hash o resultado será diferente.

	}}		}}

Rodrigogml: /* Estabelecendo Paridade de Conversão - MeasureRulerEquivalenceIntercade */

2021-11-23T14:13:01Z

Estabelecendo Paridade de Conversão - MeasureRulerEquivalenceIntercade

← Edição anterior		Edição das 14h13min de 23 de novembro de 2021
Linha 72:		Linha 72:
	{{stop\|Informações Redundantes\|Só devemos ter uma unidade de medida de cada dimensão. Incluir na Hash múltiplas informações da mesma dimensão é desnecessário, e podem resultar em resultados "aleatórios" se elas não forem coerentes.		{{stop\|Informações Redundantes\|Só devemos ter uma unidade de medida de cada dimensão. Incluir na Hash múltiplas informações da mesma dimensão é desnecessário, e podem resultar em resultados "aleatórios" se elas não forem coerentes.
	Exemplo:		Exemplo:
	* Incluir 1Kg, 1000g e 50Unidades - A hash aceitará a unidade de medida KILOGRAM e GRAM, mas a informação é redundante, mas não causará nenhum problema.		'''Incluir 1Kg, 1000g e 50Unidades''' - A hash aceitará a unidade de medida KILOGRAM e GRAM, mas a informação é redundante, mas não causará nenhum problema.
	* Incluir 1Kg, 500g e 50Unidades - Informar que 1Kg é equivalente à 500g é uma informação incoerente. Ao procurar as equivalências para converter Unidades em Massa, o MeasureRuler pode hora utilizar a informação de 1Kg = 50 Unidades, hora utilizar 500g = 50Unidades. Dependendo da informação que encontrar primeiro na Hash o resultado será diferente.		'''Incluir 1Kg, 500g e 50Unidades''' - Informar que 1Kg é equivalente à 500g é uma informação incoerente. Ao procurar as equivalências para converter Unidades em Massa, o MeasureRuler pode hora utilizar a informação de 1Kg = 50 Unidades, hora utilizar 500g = 50Unidades. Dependendo da informação que encontrar primeiro na Hash o resultado será diferente.
	}}		}}

Rodrigogml em 14h12min de 23 de novembro de 2021

2021-11-23T14:12:36Z

← Edição anterior		Edição das 14h12min de 23 de novembro de 2021
Linha 51:		Linha 51:
	Para evitar esse problemas as unidades de medidas devem '''sempre ter nomes diferentes mesmo que em dimensões distintas'''. Embora não conheça nenhuma unidade de medida que tenha o mesmo o nome e represente coisas diferentes, é bom que o DEV tenha ciência dessa situação.		Para evitar esse problemas as unidades de medidas devem '''sempre ter nomes diferentes mesmo que em dimensões distintas'''. Embora não conheça nenhuma unidade de medida que tenha o mesmo o nome e represente coisas diferentes, é bom que o DEV tenha ciência dessa situação.
	}}		}}

			= Unidades de Medidas Personalizadas =

			O MeasureRuler permite que o usuário crie suas próprias unidades de medidas bastando apenas definir um nome e um símbolo. Em uma classe que estenda a interface '''MeasureUnit'''. Para que a unidade de medida se torne funcional será ainda necessário estabelecer uma régua de equivalências, explicado no tópico de utilização.

			{{note\|Persistência de Unidades de Medidas Personalizadas\|Vale ressaltar que as unidades de medidas personalizadas não podem ser persistidas com o MeasureUnitDAOConverter. Esses objetos devem ser persistidos em atributos separados como um objeto do sistema, ou o desenvolvedor deve implementar seu próprio converter para o determinado atributo.}}


			= Estabelecendo Paridade de Conversão - MeasureRulerEquivalenceIntercade =

			Embora o MeasureRuler já seja capaz de converter unidades de medidas dentro da mesma dimensão, é possível estabelecer equivalências entre as unidades de medidas. Como, por exemplo, estabelecer que 1 unidade tem 50g, e depois disso pedir que a régua converta 1 Dúzia em Kilos.

			Essas paridades são definidas apenas implementando a interface '''MeasureRulerEquivalenceInterface'''. Nela há apenas um método que deve retornar uma '''Hash<MeasureUnit, BigDecimal>'''. A chave da hash é qualquer unidade de medida, e seu valor é um BigDecimal que estabelece o peso da unidade de medida. Exemplos:
			* '''1 Unidade = 50g = 30ml''' - Devemos ter os seguintes objetos na Hash:
			** hash.put(UnitUnit.UNIT, BigDecimal.ONE);
			** hash.put(WeightUnit.GRAM, new BigDecimal("50");
			** hash.put(VolumeUnit.MILILITER, new BigDecimal("30");


			{{stop\|Informações Redundantes\|Só devemos ter uma unidade de medida de cada dimensão. Incluir na Hash múltiplas informações da mesma dimensão é desnecessário, e podem resultar em resultados "aleatórios" se elas não forem coerentes.
			Exemplo:
			* Incluir 1Kg, 1000g e 50Unidades - A hash aceitará a unidade de medida KILOGRAM e GRAM, mas a informação é redundante, mas não causará nenhum problema.
			* Incluir 1Kg, 500g e 50Unidades - Informar que 1Kg é equivalente à 500g é uma informação incoerente. Ao procurar as equivalências para converter Unidades em Massa, o MeasureRuler pode hora utilizar a informação de 1Kg = 50 Unidades, hora utilizar 500g = 50Unidades. Dependendo da informação que encontrar primeiro na Hash o resultado será diferente.
			}}


			Com esses três objetos estabelecemos a referência entre as dimensões Unidades, Massa e Volume. Podendo converter de Toneladas para Centimetros Cúbicos, por exemplo. Para estabelecer, uma referência com uma unidade de medida personalizada basta colocar na Hash a instância da unidade de media personalizada na Hash e estabelecer o seu peso em comparação as demais unidades presentes na Hash.

			= Utilização da Régua =

			Para realizar a conversão das unidades de medidas, utilizando ou não a régua de equivalências e/ou unidades de medidas pesonalizadas, devemos focar nos métodos '''.convertTo(...)''' da classe '''MeasureRuler'''. Há métodos simples utilizados para conversão dentro da mesma dimensão (sem utilização de equivalências) até métodos completos com a entrada de equivalências e definição da precisão de casas decimais.

Rodrigogml: /* Unidades Personalizadas */

2021-11-23T13:48:30Z

Unidades Personalizadas

← Edição anterior		Edição das 13h48min de 23 de novembro de 2021
Linha 6:		Linha 6:

	A classe MeasureRuler apresenta os métodos para conversão de forma estática. Para mais informações consulte o JavaDoc da classe.		A classe MeasureRuler apresenta os métodos para conversão de forma estática. Para mais informações consulte o JavaDoc da classe.

	~~= Unidades Personalizadas =~~

	O MeasureRuler deve em breve ter um sistema para definição de unidades personalizadas e consequentemente uma regra para conversão. Por exemplo, deve ser possível criar uma unidade de medida batizada pelo usuário de "Bandeija", ou de "Palete" ou ainda "Jigawbaca" que podem representar X unidades, ou X Kilos conforme sua vontade. E a partir dessa definição o MeasureRuler ser capaz de realizar suas conversões.


	= MeasureUnit =		= MeasureUnit =

Rodrigogml: /* MeasureUnit */

2021-11-23T13:48:09Z

MeasureUnit

← Edição anterior		Edição das 13h48min de 23 de novembro de 2021
Linha 14:		Linha 14:
	= MeasureUnit =		= MeasureUnit =

	O MeasureRuler suporta várias dimensões de medidas~~, e cada~~ dimensão várias unidades de medidas. ~~Cada Dimensão~~ é definida pela enumeration '''MeasureDimension'''. Já as unidades de cada unidade de medida são definidas pela sua própria enumeration. Por exemplo:		O MeasureRuler suporta várias dimensões de medidas. Cada dimensão pode conter várias unidades de medidas. A dimensão é definida pela enumeration '''MeasureDimension'''. Já as unidades de cada unidade de medida são definidas pela sua própria enumeration que estendem a interface '''MeasureUnit'''. Por exemplo:
	* '''Volume''' - VolumeUnit		* '''Volume''' - VolumeUnit
	* '''Comprimento''' - LengthUnit		* '''Comprimento''' - LengthUnit
Linha 24:		Linha 24:
	== Interface MeasureUnit ==		== Interface MeasureUnit ==

	~~Note que uma vez que cada~~ dimensão tem suas unidades de medidas em enumerations diferentes, quando precisamos ~~de um atributo que possa~~ representar qualquer uma das unidades de medida~~, mesmo que de dimensões diferentes não era possível a não ser criando um atributo do tipo Object ou Enum<?>. Para melhorar~~ essa ~~informação, todas as enumerações de unidades de medida implementam a~~ interface ~~'''MeasureUnit'''~~. ~~Essa interface deve ser utilizada sempre que desejamos um atributo que represente mais de uma dimensão de medida. Por~~ exemplo, ao cadastrar um produto no sistema, a "unidade básica de estoque" dele pode ser tanto Unidades, quando Metros, Kilos, Metros Quadrados, etc.		Cada dimensão tem suas unidades de medidas em enumerations diferentes. Assim, quando precisamos representar qualquer uma das unidades de medida utilizamos essa interface. Um exemplo: ao cadastrar um produto no sistema, a "unidade básica de estoque" dele pode ser tanto Unidades, quando Metros, Kilos, Metros Quadrados, etc.. Assim, a melhor maneira de definir este atributo é através desta interface.

	A interface MeasureUnit apresenta métodos como getDimension(), que retorna a enumeration de MeasureDimension para indicar que Dimensão de Medida esta Unidade pertence.		A interface '''MeasureUnit''' apresenta métodos como '''getDimension()''', que retorna a enumeration de '''MeasureDimension''' para indicar que Dimensão de Medida esta Unidade pertence.


	== Persistência da Interface MeasureUnit - MeasureUnitDAOConverter ==		== Persistência da Interface MeasureUnit - MeasureUnitDAOConverter ==

	~~No fundo como trata~~-se de uma enumeration, o padrão do ~~BIS~~ é que no banco seja um campo do tipo varchar(50) (O limite recomendado de enums no BIS é de 50 chars~~, embora haja uma real limitação~~). Mas uma vez que a MeasureUnit é uma interface, o BISDAO não sabe como proceder para persisti-la e reconstruir o VO com os dados do banco. Para isso temos de utilizar uma '''BISDAOConverter'''. E para simplificar o MeasureRuler já oferece uma implementação pronta para isso a '''MeasureUnitDAOConverter'''.		Por tratar-se de uma enumeration, o padrão do FW é que no banco seja um campo do tipo varchar(50) (O limite recomendado de enums no BIS é de 50 chars). Mas uma vez que a MeasureUnit é uma interface, o BISDAO não sabe como proceder para persisti-la e reconstruir o VO com os dados do banco. Para isso temos de utilizar uma '''BISDAOConverter'''. E para simplificar o MeasureRuler já oferece uma implementação pronta para isso a '''MeasureUnitDAOConverter'''.

	~~Assim, para~~ definir um atributo no VO que seja do tipo MeasureUnit devemos ter algo como:		Para definir um atributo no VO que seja do tipo '''MeasureUnit''' devemos ter algo como:

	{{java\|Exemplos de ~~Composição~~\|<syntaxhighlight lang="java">		{{java\|Exemplos de Declaração\|<syntaxhighlight lang="java">

	@BISDAOConverter(converterClass = MeasureUnitDAOConverter.class)		@BISDAOConverter(converterClass = MeasureUnitDAOConverter.class)
Linha 44:		Linha 44:


	~~Desta forma, sempre~~ que o BISDAO lêr a String no banco de dados que representa a unidade de medida, o Converter conseguirá descobrir de qual enumeration devemos realizar o "valueOf(...)".		Sempre que o BISDAO lêr a String no banco de dados que representa a unidade de medida, o Converter conseguirá descobrir de qual enumeration devemos realizar o "valueOf(...)".


	Note que o método utilizado dentro do converter é o		Note que o método utilizado dentro do converter é o
	<pre>MeasureRuler.valueOf(...);</pre>		<pre>MeasureRuler.valueOf(...);</pre>
			, sempre que for necessário desserializar da String para uma das unidades de medida, esse método fará o trabalho.


	~~Ou seja, sempre for necessário desserializar da String para uma das unidades de medida, esse método fará o trabalho.~~		{{stop\|Unidades de Medidas Iguais\|Por conta de termos várias unidades de medidas de dimensões diferentes representadas em enumerations diferentes, o Java permitirá que tenhamos uma unidade de medida "X" tanto em '''VolumeUnit''' quanto em '''AreaUnit'''. Embora o Java não tenha problemas para compilar esse código, ao ser persistido no banco de dados (salvo apenas o NAME da enumeration), a recuperação do objeto é baseada apenas no nome da enumeration. Isso fará com que seja sempre retornada pela primeira enumeration que o código procura.


	{{stop\|Unidades de Medidas Iguais\|~~Note que por~~ conta de termos várias unidades de medidas de dimensões diferentes representadas em enumerations diferentes, o Java permitirá que tenhamos uma unidade de medida "X" tanto em '''VolumeUnit''' quanto em '''AreaUnit'''. Embora o Java não tenha problemas para compilar esse código, ~~caso isso ocorra uma vez que~~ o ~~valor seja persistido~~, a ~~restituição~~ baseada só no nome da enumeration ~~será~~ sempre retornada pela primeira enumeration que o código procura~~. Retornando o tipo errado em muitos cassos~~.

	Para evitar esse problemas as unidades de medidas devem '''sempre ter nomes diferentes mesmo que em dimensões distintas'''. Embora não conheça nenhuma unidade de medida que tenha o mesmo o nome e represente coisas diferentes, é bom que o DEV tenha ciência dessa situação.		Para evitar esse problemas as unidades de medidas devem '''sempre ter nomes diferentes mesmo que em dimensões distintas'''. Embora não conheça nenhuma unidade de medida que tenha o mesmo o nome e represente coisas diferentes, é bom que o DEV tenha ciência dessa situação.
	}}		}}

Rodrigogml: Criou página com 'O MeasureRuler é, pela própria tradução, uma régua de medidas. Essa régua de medidas tem a intenção de oferecer aos sistemas a facilidade para converter unidades de me...'

2020-10-15T14:20:39Z

Criou página com 'O MeasureRuler é, pela própria tradução, uma régua de medidas. Essa régua de medidas tem a intenção de oferecer aos sistemas a facilidade para converter unidades de me...'

Página nova

O MeasureRuler é, pela própria tradução, uma régua de medidas. Essa régua de medidas tem a intenção de oferecer aos sistemas a facilidade para converter unidades de medidas da mesma dimensão, ou mesmo entre dimensões diferentes quando estabelecida a regra de conversão.

Definições:
* '''Dimensão''' - tipo de medida utiliza, como "Comprimento", "Área", "Volume", "Massa (Peso)", etc. Embora estas hoje sejam as dimensões que o BIS suporta, nada impede de se criar dimensões mais complexas como "Energia", "Luminosidade", "Torque", e assim por diante.
* '''Unidade de Medida''' - Unidade de medida utilizada para medir a '''Dimensão''' desejada. Por exemplo, comprimento pode ser medido em "Metros", "Centimetros", "Pés", "Polegadas", etc. "Massa" pode ser medida em "Arrobas", "Kilos", "Pounds", etc.

A classe MeasureRuler apresenta os métodos para conversão de forma estática. Para mais informações consulte o JavaDoc da classe.

= Unidades Personalizadas =

O MeasureRuler deve em breve ter um sistema para definição de unidades personalizadas e consequentemente uma regra para conversão. Por exemplo, deve ser possível criar uma unidade de medida batizada pelo usuário de "Bandeija", ou de "Palete" ou ainda "Jigawbaca" que podem representar X unidades, ou X Kilos conforme sua vontade. E a partir dessa definição o MeasureRuler ser capaz de realizar suas conversões.

= MeasureUnit =

O MeasureRuler suporta várias dimensões de medidas, e cada dimensão várias unidades de medidas. Cada Dimensão é definida pela enumeration '''MeasureDimension'''. Já as unidades de cada unidade de medida são definidas pela sua própria enumeration. Por exemplo:
* '''Volume''' - VolumeUnit
* '''Comprimento''' - LengthUnit
* '''Área''' - AreaUnit
* '''Massa (peso)''' - WeightUnit
* '''Unidades''' - UnitUnit

== Interface MeasureUnit ==

Note que uma vez que cada dimensão tem suas unidades de medidas em enumerations diferentes, quando precisamos de um atributo que possa representar qualquer uma das unidades de medida, mesmo que de dimensões diferentes não era possível a não ser criando um atributo do tipo Object ou Enum<?>. Para melhorar essa informação, todas as enumerações de unidades de medida implementam a interface '''MeasureUnit'''. Essa interface deve ser utilizada sempre que desejamos um atributo que represente mais de uma dimensão de medida. Por exemplo, ao cadastrar um produto no sistema, a "unidade básica de estoque" dele pode ser tanto Unidades, quando Metros, Kilos, Metros Quadrados, etc.

A interface MeasureUnit apresenta métodos como getDimension(), que retorna a enumeration de MeasureDimension para indicar que Dimensão de Medida esta Unidade pertence.

== Persistência da Interface MeasureUnit - MeasureUnitDAOConverter ==

No fundo como trata-se de uma enumeration, o padrão do BIS é que no banco seja um campo do tipo varchar(50) (O limite recomendado de enums no BIS é de 50 chars, embora haja uma real limitação). Mas uma vez que a MeasureUnit é uma interface, o BISDAO não sabe como proceder para persisti-la e reconstruir o VO com os dados do banco. Para isso temos de utilizar uma '''BISDAOConverter'''. E para simplificar o MeasureRuler já oferece uma implementação pronta para isso a '''MeasureUnitDAOConverter'''.

Assim, para definir um atributo no VO que seja do tipo MeasureUnit devemos ter algo como:

{{java|Exemplos de Composição|<syntaxhighlight lang="java">

@BISDAOConverter(converterClass = MeasureUnitDAOConverter.class)
@BISMetaGenericField(caption = "Unidade de Medida", required = true)
private MeasureUnit measureUnit = null;

</syntaxhighlight>}}

Desta forma, sempre que o BISDAO lêr a String no banco de dados que representa a unidade de medida, o Converter conseguirá descobrir de qual enumeration devemos realizar o "valueOf(...)".

Note que o método utilizado dentro do converter é o
<pre>MeasureRuler.valueOf(...);</pre>

Ou seja, sempre for necessário desserializar da String para uma das unidades de medida, esse método fará o trabalho.

{{stop|Unidades de Medidas Iguais|Note que por conta de termos várias unidades de medidas de dimensões diferentes representadas em enumerations diferentes, o Java permitirá que tenhamos uma unidade de medida "X" tanto em '''VolumeUnit''' quanto em '''AreaUnit'''. Embora o Java não tenha problemas para compilar esse código, caso isso ocorra uma vez que o valor seja persistido, a restituição baseada só no nome da enumeration será sempre retornada pela primeira enumeration que o código procura. Retornando o tipo errado em muitos cassos.

Para evitar esse problemas as unidades de medidas devem '''sempre ter nomes diferentes mesmo que em dimensões distintas'''. Embora não conheça nenhuma unidade de medida que tenha o mesmo o nome e represente coisas diferentes, é bom que o DEV tenha ciência dessa situação.
}}