csbase.client.util

Class ClientUtilities

java.lang.Object

csbase.client.util.ClientUtilities

public class ClientUtilities
extends java.lang.Object

A classe ClientUtilities provê uma coleção de métodos úteis para as interfaces do sistema.

Version:

$Revision: 150777 $

Constructor Summary

Constructors

Constructor and Description
ClientUtilities()

Method Summary

Methods

Modifier and Type	Method and Description
static void	addComponent2Panel(javax.swing.JPanel panel, javax.swing.JComponent component, java.awt.GridBagConstraints c, int gx, int gy, int w, int h, int wx, int wy) Adiciona um componente gráfico do Swing em um panel usando o GridBagLayout que será configurado pelos parâmetros.
static java.lang.String	addSystemAndServerNameToTitle(java.lang.String title) Adiciona o nome do sistema a um título de janela, usando o formato: "titulo - nome do sistema".
static java.lang.String	addSystemNameToTitle(java.lang.String title) Adiciona o nome do sistema a um título de janela, usando o formato: "titulo - nome do sistema".
static void	adjustEqualSizes(javax.swing.JComponent... comps) Ajuste de um conjunto de elementos de interface para o mesmo tamanho.
static void	applyUndoRedoActions(javax.swing.text.JTextComponent textcomp) Aplica e gerencia ações de 'desfazer' e 'refazer' no componente de texto indicado.
static void	centerWindow(java.awt.Window window, java.awt.Window refWindow) Centraliza uma janela em relação a outra janela de referência.
static javax.swing.JPanel	createBasicGridPanel(javax.swing.JComponent[][] rows) Cria um painel "básico" diagramado por um GridBagLayout.
static javax.swing.JButton	createImageButton(javax.swing.ImageIcon icon) Método para a criação de botões baseados em imagens, já devidamente ajustados em seus tamanhos etc.
static java.util.Comparator	getStringComparatorIgnoreCase() Recupera um comparador de strings que ignora letras com acento, maiúsculas e minúsculas.
static boolean	isValidFileName(java.lang.String name) Verifica se o nome é composto apenas por caracteres alfanuméricos, underscore (_) ou ponto (.) ou traco (-).
static boolean	loadStringMap(java.util.Locale locale) Método para carga de strings de texto baseado em um Locale.
static void	populateBasicGridPanel(javax.swing.JPanel basicGridPanel, javax.swing.JComponent[][] rows) Popula um painel.
static void	setLanguage(java.util.Locale locale) Método para carga de strings de mensagens baseado em um Locale.
static void	showErrorByButton(java.awt.Window window, java.lang.String msg, javax.swing.JButton button) Aviso de erro de preenchimento de campo qualquer com abertura de pop-up, seleção do texto indicado e alerta no label correspondente.
static void	showErrorByComponent(java.awt.Window window, java.lang.Exception exception, javax.swing.JLabel label, javax.swing.JComponent component) Aviso de erro de preenchimento de campo qualquer com abertura de pop-up, seleção do texto indicado e alerta no label correspondente.
static void	showErrorByComponent(java.awt.Window window, java.lang.String msg, javax.swing.JLabel label, javax.swing.JComponent component) Aviso de erro de preenchimento de campo qualquer com abertura de pop-up, seleção do texto indicado e alerta no label correspondente.
static void	showErrorByTable(java.awt.Window window, java.lang.String msg, javax.swing.JLabel label, javax.swing.JTable table, int row, int col) Aviso de erro de preenchimento de célula de tabela com abertura de pop-up, seleção do texto indicado e alerta no label correspondente.
static void	showErrorByTextField(java.awt.Window window, java.lang.String msg, javax.swing.JLabel label, javax.swing.JTextField field) Aviso de erro de preenchimento de campo de text-box com abertura de pop-up, seleção do texto indicado e alerta no label correspondente.
static void	trimImageButton(javax.swing.JButton button) Método que ajusta o tamanho do botão para que ele seja do tamanho razoável (praticamente o mínimo) para exibir o seu ícone.
static boolean	validatePathChars(java.lang.String path) Verifica se o path é composto apenas por caracteres alfanuméricos, separador de diretorio (/), underscore (_) ou ponto (.) ou traco (-).

Methods inherited from class java.lang.Object

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

Constructor Detail

ClientUtilities

public ClientUtilities()

Method Detail

addSystemNameToTitle

public static java.lang.String addSystemNameToTitle(java.lang.String title)

Adiciona o nome do sistema a um título de janela, usando o formato: "titulo - nome do sistema". Provisoriamente, o nome do sistema é determinado pela propriedade "SERVER", obtida no arquivo de idiomas. O nome dessa propriedade é inadequado, porém ela é usada intensamente no código, e redefinida pelos sistemas construídos a partir do CSBase. Quando possível, é conveniente alterar o nome dessa propriedade (ou criar uma outra propriedade para isso).

Parameters:

title - o título da janela

Returns:

o título acrescido do nome do sistema

addSystemAndServerNameToTitle

public static java.lang.String addSystemAndServerNameToTitle(java.lang.String title)

Adiciona o nome do sistema a um título de janela, usando o formato: "titulo - nome do sistema". Provisoriamente, o nome do sistema é determinado pela propriedade "SERVER", obtida no arquivo de idiomas. O nome dessa propriedade é inadequado, porém ela é usada intensamente no código, e redefinida pelos sistemas construídos a partir do CSBase. Quando possível, é conveniente alterar o nome dessa propriedade (ou criar uma outra propriedade para isso).

Parameters:

title - o título da janela

Returns:

o título acrescido do nome do sistema

adjustEqualSizes

public static void adjustEqualSizes(javax.swing.JComponent... comps)

Ajuste de um conjunto de elementos de interface para o mesmo tamanho.

Parameters:

comps - os widgets que serão ajustados.

createImageButton

public static javax.swing.JButton createImageButton(javax.swing.ImageIcon icon)

Método para a criação de botões baseados em imagens, já devidamente ajustados em seus tamanhos etc.

Parameters:

icon - Objeto ImageIcon usado como ícone.

Returns:

.

trimImageButton

public static void trimImageButton(javax.swing.JButton button)

Método que ajusta o tamanho do botão para que ele seja do tamanho razoável (praticamente o mínimo) para exibir o seu ícone.

Parameters:

button - O botão.

createBasicGridPanel

public static javax.swing.JPanel createBasicGridPanel(javax.swing.JComponent[][] rows)

Cria um painel "básico" diagramado por um GridBagLayout. Este tipo de painel é utilizado, tipicamente, em interações que configuram um conjunto de parâmetros textuais ou numéricos, e é composto por um número variável de linhas de componentes com as seguintes características:

• o primeiro compontente de cada linha é normalmente um label
• o segundo componente é um campo de texto ou uma combo-box
• o terceiro componente é um label ou um botão

Parameters:

rows - "array" contendo os componentes a serem inseridos no painel. Cada elemento deste array contém os componentes da linha correspondente.

Returns:

o painel criado

populateBasicGridPanel

public static void populateBasicGridPanel(javax.swing.JPanel basicGridPanel,
                          javax.swing.JComponent[][] rows)

Popula um painel.

Parameters:

basicGridPanel - painel

rows - linhas

showErrorByButton

public static void showErrorByButton(java.awt.Window window,
                     java.lang.String msg,
                     javax.swing.JButton button)

Aviso de erro de preenchimento de campo qualquer com abertura de pop-up, seleção do texto indicado e alerta no label correspondente.

Parameters:

window - .

msg - mensagem de erro

button - JButton a ser selecionado para nova edição do usuário.

showErrorByComponent

public static void showErrorByComponent(java.awt.Window window,
                        java.lang.String msg,
                        javax.swing.JLabel label,
                        javax.swing.JComponent component)

Aviso de erro de preenchimento de campo qualquer com abertura de pop-up, seleção do texto indicado e alerta no label correspondente.

Parameters:

window - .

msg - mensagem de erro

label - label a ser marcado com flag de erro.

component - JComponent a ser selecionado para nova edição do usuário.

showErrorByComponent

public static void showErrorByComponent(java.awt.Window window,
                        java.lang.Exception exception,
                        javax.swing.JLabel label,
                        javax.swing.JComponent component)

Aviso de erro de preenchimento de campo qualquer com abertura de pop-up, seleção do texto indicado e alerta no label correspondente.

Parameters:

window - .

exception - Exceção

label - label a ser marcado com flag de erro.

component - JComponent a ser selecionado para nova edição do usuário.

addComponent2Panel

public static void addComponent2Panel(javax.swing.JPanel panel,
                      javax.swing.JComponent component,
                      java.awt.GridBagConstraints c,
                      int gx,
                      int gy,
                      int w,
                      int h,
                      int wx,
                      int wy)

Adiciona um componente gráfico do Swing em um panel usando o GridBagLayout que será configurado pelos parâmetros.

Parameters:

panel - referência para o painel que conterá o componente

component - componente a ser adicionado de acordo com restrições

c - referência para o objeto que representa as restrições do GridBagLayout

gx - posição horizontal do elemento no grid

gy - posição vertical do elemento no grid

w - numero de células em uma linha (span horizontal)

h - numero de células em uma coluna (span vertical)

wx - weightx

wy - weighty

showErrorByTextField

public static void showErrorByTextField(java.awt.Window window,
                        java.lang.String msg,
                        javax.swing.JLabel label,
                        javax.swing.JTextField field)

Aviso de erro de preenchimento de campo de text-box com abertura de pop-up, seleção do texto indicado e alerta no label correspondente.

Parameters:

window - .

msg - mensagem de erro

label - label a ser marcado com flag de erro.

field - text a ser selecionado para nova edição do usuário.

showErrorByTable

public static void showErrorByTable(java.awt.Window window,
                    java.lang.String msg,
                    javax.swing.JLabel label,
                    javax.swing.JTable table,
                    int row,
                    int col)

Aviso de erro de preenchimento de célula de tabela com abertura de pop-up, seleção do texto indicado e alerta no label correspondente.

Parameters:

window - .

msg - mensagem de erro

label - label a ser marcado com flag de erro.

table - tabela a ser selecionada para nova edição do usuário.

row - linha a ser selecionada para nova edição do usuário.

col - coluna a ser selecionada para nova edição do usuário.

validatePathChars

public static boolean validatePathChars(java.lang.String path)

Verifica se o path é composto apenas por caracteres alfanuméricos, separador de diretorio (/), underscore (_) ou ponto (.) ou traco (-).

Parameters:

path - Nome a ser validado

Returns:

true se o nome estiver de acordo com as especificações do sistema

loadStringMap

public static boolean loadStringMap(java.util.Locale locale)

Método para carga de strings de texto baseado em um Locale. OBS.: Esse método foi movido para essa classe para ser possível disponibizar os recursos de mensagens para aplicações que não usam o LoginFrame do csbase

Parameters:

locale - Locale selecionado pelo usuário.

Returns:

flag indicativo de sucesso da operação.

setLanguage

public static void setLanguage(java.util.Locale locale)

Método para carga de strings de mensagens baseado em um Locale. OBS.: Esse método foi movido para essa classe para ser possível disponibizar os rescursos de mensagens para aplicações que não usam o LoginFrame do csbase

Parameters:

locale - Locale selecionado pelo usuário.

isValidFileName

public static boolean isValidFileName(java.lang.String name)

Verifica se o nome é composto apenas por caracteres alfanuméricos, underscore (_) ou ponto (.) ou traco (-).

Parameters:

name - Nome a ser validado

Returns:

true se o nome estiver de acordo com as especificações do sistema

centerWindow

public static void centerWindow(java.awt.Window window,
                java.awt.Window refWindow)

Centraliza uma janela em relação a outra janela de referência. Se a janela de referência não estiver sendo exibida, a referência é substituída pela janela que a contém (seu owner) até que seja encontrada uma janela que esteja sendo exibida, ou que se chegue ao fim da sequência. Se a janela de referência for nula, ou não houver janela de referência sendo exibida, centraliza em relação à tela.

Parameters:

window - janela a ser centralizada.

refWindow - janela de referência.

getStringComparatorIgnoreCase

public static final java.util.Comparator getStringComparatorIgnoreCase()

Recupera um comparador de strings que ignora letras com acento, maiúsculas e minúsculas. Esse comparador implementa Serializable.

Returns:

applyUndoRedoActions

public static void applyUndoRedoActions(javax.swing.text.JTextComponent textcomp)

Aplica e gerencia ações de 'desfazer' e 'refazer' no componente de texto indicado.

• CTRL + Z = desfazer
• CTRL + Y = refazer

Parameters:

textcomp - - o componente de texto que será incrementado.