Class PolicyPanel

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

net.adoptopenjdk.icedteaweb.client.controlpanel.NamedBorderPanel

net.adoptopenjdk.icedteaweb.client.controlpanel.panels.PolicyPanel

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible

public class PolicyPanel
extends NamedBorderPanel

Implements a Policy Settings panel for the itweb-settings control panel. This gives the user information about custom user-level JNLP Policy files, as well as offering a way to launch a policy file editor with the correct file path to the user's personal policy file location presupplied.

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private class	PolicyPanel.LaunchPolicyToolAction	Implements the action to be performed when the "Advanced" button is clicked
private class	PolicyPanel.LaunchSimplePolicyEditorAction

Nested classes/interfaces inherited from class JPanel

JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field	Description
private static final Logger	LOG
private PolicyEditor.PolicyEditorWindow	policyEditor

Fields inherited from class JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor	Description
PolicyPanel(DeploymentConfiguration config)

Method Summary

Modifier and Type	Method	Description
private Component	getParentComponentOfSource(ActionEvent event)
private static boolean	isPolicyToolAvailable()
private static void	launchPolicyTool(Component parentComponent, String filePath)	Launch the policytool for a specified file path
private void	launchSimplePolicyEditor(String filePath)	Launch the simplified PolicyEditor for a specified file path.
private static String	localFilePathFromUrlString(String url)	Loosely attempt to get the path part of a file URL string.
private static void	policyToolLaunchHelper(Component parentComponent, String filePath)	This executes a new process for policytool using ProcessBuilder, with the new process' working directory set to the user's home directory.
private static void	reflectivePolicyToolLaunch(String filePath)	This is used as a fallback in case launching the policytool by executing a new process fails.

Methods inherited from class JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class Object

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

Field Details

LOG

private static final Logger LOG

policyEditor

private PolicyEditor.PolicyEditorWindow policyEditor

Constructor Details

PolicyPanel

public PolicyPanel(DeploymentConfiguration config)

Method Details

launchPolicyTool

private static void launchPolicyTool(Component parentComponent,
 String filePath)

Launch the policytool for a specified file path

Parameters:

parentComponent - a Component to act as parent to warning dialogs which may appear

filePath - a String representing the path to the file to be opened

launchSimplePolicyEditor

private void launchSimplePolicyEditor(String filePath)

Launch the simplified PolicyEditor for a specified file path.

Parameters:

filePath - a String representing the path to the file to be opened

policyToolLaunchHelper

private static void policyToolLaunchHelper(Component parentComponent,
 String filePath)

This executes a new process for policytool using ProcessBuilder, with the new process' working directory set to the user's home directory. policytool then attempts to open the provided policy file path, if policytool can be run. ProcessBuilder does some verification to ensure that the built command can be executed - if not, it throws an IOException. In this event, we try our reflective fallback launch. We do this in a new Thread to ensure that the fallback launch does not block the AWT thread, and neither does ProcessBuilder#start() in case it happens to be synchronous on the current system.

Parameters:

parentComponent - a Component to act as parent to warning dialogs which may appear

filePath - a String representing the path to the file to be opened

reflectivePolicyToolLaunch

private static void reflectivePolicyToolLaunch(String filePath)
                                        throws Exception

This is used as a fallback in case launching the policytool by executing a new process fails. This probably happens because we are running on a system where the policytool executable is not on the PATH, or because we are running on a non-POSIX compliant system. We do this reflectively to avoid needing to add PolicyTool as build dependency simply for this small edge case.

Parameters:

filePath - a String representing the path of the file to attempt to open

Throws:

Exception - if any sort of exception occurs during reflective launch of policytool

isPolicyToolAvailable

private static boolean isPolicyToolAvailable()

localFilePathFromUrlString

private static String localFilePathFromUrlString(String url)

Loosely attempt to get the path part of a file URL string. If this fails, simply return back the input. This is only intended to be used for displaying GUI elements such as the CPPolicyTooltip.

Parameters:

url - the String representing the URL whose path is desired

Returns:

a String representing the local filepath of the given file:/ URL

getParentComponentOfSource

private Component getParentComponentOfSource(ActionEvent event)