com.nelkinda.javax.swing

Enum SwingUtilitiesN

java.lang.Object

java.lang.Enum<SwingUtilitiesN>

com.nelkinda.javax.swing.SwingUtilitiesN

All Implemented Interfaces:

Serializable, Comparable<SwingUtilitiesN>

public enum SwingUtilitiesN
extends Enum<SwingUtilitiesN>

A collection of utility methods for Swing.

Since:

0.0.2

Version:

0.0.2

Author:

Christian Hujer, Nelkinda Software Craft Pvt Ltd

See Also:

SwingUtilities

Method Summary

Modifier and Type	Method and Description
static <T> T	callAndWait(@NotNull Callable<T> callable) Causes callable.call() to be executed synchronously on the AWT event dispatching thread.
static <T> FutureTask<T>	callLater(@NotNull Callable<T> callable) Causes callable.call() to be executed asynchronously on the AWT event dispatching thread.
static <T extends Component> Optional<T>	findComponent(@NotNull Class<T> componentClass, Container... containers) Finds a component in a list of containers.
static <T extends Component> Optional<T>	findComponent(@NotNull Predicate test, Container... containers) Finds a component in a list of containers.
static Optional<JMenu>	findJMenu(JMenuBar jMenuBar, String actionCommand)
static Optional<JMenu>	findJMenu(JMenu jMenu, String actionCommand)
static String[]	getColumnNames(@NotNull JTable jTable)
static ImageIcon	getImageIcon(String urlString)
static List<String[]>	getTableValues(@NotNull JTable jTable)
static void	initActionFromBundle(@NotNull Action action, @NotNull ResourceBundle resourceBundle) Initializes an action from a ResourceBundle.
static void	initActionFromBundle(@NotNull Action action, @NotNull String actionCommand, @NotNull ResourceBundle resourceBundle) Initializes an action from a ResourceBundle.
static void	setLookAndFeelFromClassName(String className, Window frame)
static void	setLookAndFeelFromName(@Nullable String lookAndFeelName) Sets the current look and feel to the look and feel specified by lookAndFeelName.
static SwingUtilitiesN	valueOf(String name) Returns the enum constant of this type with the specified name.
static SwingUtilitiesN[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Method Detail

values

public static SwingUtilitiesN[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (SwingUtilitiesN c : SwingUtilitiesN.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static SwingUtilitiesN valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

findComponent

public static <T extends Component> Optional<T> findComponent(@NotNull
                                                              @NotNull Class<T> componentClass,
                                                              @NotNull
                                                              Container... containers)

Finds a component in a list of containers.

Type Parameters:

T - Type of the component to find.

Parameters:

componentClass - Class of the component to find.

containers - Containers in which to find a component of the specified class.

Returns:

Found component or null.

Throws:

NullPointerException - in case componentClass or containers is null.

IllegalArgumentException - in case componentClass or containers is null (IntelliJ IDEA).

findComponent

public static <T extends Component> Optional<T> findComponent(@NotNull
                                                              @NotNull Predicate test,
                                                              @NotNull
                                                              Container... containers)

Finds a component in a list of containers.

Type Parameters:

T - Type of the component to find.

Parameters:

test - Predicate to find the component.

containers - Containers in which to find a component of the specified class.

Returns:

Found component or null.

Throws:

NullPointerException - in case componentClass or containers is null.

IllegalArgumentException - in case componentClass or containers is null (IntelliJ IDEA).

callAndWait

public static <T> T callAndWait(@NotNull
                                @NotNull Callable<T> callable)
                         throws InvocationTargetException,
                                InterruptedException,
                                ExecutionException

Causes callable.call() to be executed synchronously on the AWT event dispatching thread. This blocks until all pending AWT events have been processed and (then) callable.call() returns. This method should be used when an application thread needs to update the GUI. It shouldn't be called from the event dispatching thread. Here's an Example that shows a dialog from an application thread.

 new Thread(() -> {
     try {
         System.err.println(SwingUtilitiesN.callAndWait(() -> JOptionPane.showInputDialog("Enter your name")));
     } catch (final InvocationTargetException | InterruptedException | ExecutionException e) {
         e.printStackTrace();
     }
 }).start();
 

Type Parameters:

T - The type of the return value of callable

Parameters:

callable - Callable to execute on the event thread.

Returns:

The return value of callable

Throws:

ExecutionException - if an exception is thrown while running callable

InterruptedException - if we're interrupted while waiting for the event dispatching thread to finish executing callable.call()

InvocationTargetException - if an exception is thrown within FutureTask before or after callable.call()

NullPointerException - in case callable is null.

IllegalArgumentException - in case callable is null (IntelliJ IDEA).

callLater

public static <T> FutureTask<T> callLater(@NotNull
                                          @NotNull Callable<T> callable)

Causes callable.call() to be executed asynchronously on the AWT event dispatching thread. This will happen after all pending AWT events have been processed. This method should be used when an application thread needs to update the GUI.

Type Parameters:

T - The type of the return value of callable

Parameters:

callable - Callable to execute on the event thread.

Returns:

The future representing the task for running callable.

Throws:

NullPointerException - in case callable is null.

IllegalArgumentException - in case callable is null (IntelliJ IDEA).

setLookAndFeelFromName

public static void setLookAndFeelFromName(@Nullable
                                          @Nullable String lookAndFeelName)

Sets the current look and feel to the look and feel specified by lookAndFeelName.

Parameters:

lookAndFeelName - Name of the look and feel to set, for example "Metal" or "Nimbus". If this is null, the look and feel remains unchanged.

initActionFromBundle

public static void initActionFromBundle(@NotNull
                                        @NotNull Action action,
                                        @NotNull
                                        @NotNull String actionCommand,
                                        @NotNull
                                        @NotNull ResourceBundle resourceBundle)

Initializes an action from a ResourceBundle.

Parameters:

action - Action to initialize.

actionCommand - actionCommand, at the same time the base for the keys in the resourceBundle.

resourceBundle - ResourceBundle from which to initialize the action.

Throws:

NullPointerException - in case action or actionCommand or resourceBundle is null.

IllegalArgumentException - in case action or actionCommand or resourceBundle is null (IntelliJ IDEA).

initActionFromBundle

public static void initActionFromBundle(@NotNull
                                        @NotNull Action action,
                                        @NotNull
                                        @NotNull ResourceBundle resourceBundle)

Initializes an action from a ResourceBundle. The action must have Action.ACTION_COMMAND_KEY set or this method will throw a NullPointerException.

Parameters:

action - Action to initialize (with set Action.ACTION_COMMAND_KEY).

resourceBundle - ResourceBundle from which to initialize the action.

Throws:

NullPointerException - in case action or actionCommand.getValue(ACTION_COMMAND_KEY) or resourceBundle is null.

IllegalArgumentException - in case action or actionCommand.getValue(ACTION_COMMAND_KEY) or resourceBundle is null (IntelliJ IDEA).

getImageIcon

public static ImageIcon getImageIcon(String urlString)

getColumnNames

public static String[] getColumnNames(@NotNull
                                      @NotNull JTable jTable)

getTableValues

public static List<String[]> getTableValues(@NotNull
                                            @NotNull JTable jTable)

setLookAndFeelFromClassName

public static void setLookAndFeelFromClassName(String className,
                                               Window frame)

findJMenu

public static Optional<JMenu> findJMenu(JMenuBar jMenuBar,
                                        String actionCommand)

findJMenu

public static Optional<JMenu> findJMenu(JMenu jMenu,
                                        String actionCommand)