eu.bandm.tools.installer

Class DownloadDialog_DeEn

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Window

java.awt.Dialog

javax.swing.JDialog

eu.bandm.tools.graficUtils.TextDialog

eu.bandm.tools.installer.DownloadDialog_DeEn

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible, RootPaneContainer, WindowConstants

Deprecated.

uses jawaws/JNLP, which is deprecated since jse 9 and no more contained in jse 11. Use instead.

@Deprecated
public class DownloadDialog_DeEn
extends TextDialog

Complex multi-lingual dialog for installing "DES" = "Documentation, Examples and Sources" on the local machine. Could be used for other kinds of archives when the texts are adjusted accordingly. The initial situation when calling may be

 
    position and checksums of DES known,            |  unknown
    due to jnlp (or to previous call in the         |  
    same application)                               |
      calculate checksum anew                       |
    digest identical, files  | differ, files changed|
      unchanged              |                      |
                             |                      |
    uptodate | outofdate     | uptodate | outofdate |
             |               |          |           |
  ----print this situation----------------------------------------
 ask for user wishes
    1) download DES ..........................................
    2) browse local copy ..........................
    3) browse web copy ......................................
    4) terminate this dialog .................................
 
  ---- download process ------------------------------------------
   online                    |
   load zip                  |
   unzip                     |
   calculate md5             |

  ---- AFTER return / caller's level -----------------------------
   store to jnlp-persistency

 

The architecture is as follows

      +--------------------+
      |JDialog             |
      |                    |
      +--------------------+
               /_\
                |
      +--------------------+
      |TextDialog          |
      |                    |
      +--------------------+
               /_\
                |                         +-------------------------+     +-----
      +--------------------+              | GetAndUnpackZipArchive  |---<>| MessageRcv ???
      |DownloadDialog_DeEn | -----------<>|  .fromTo()              |     +_______
      |                    |              +-------------------------+
      +--------------------+                +--------------------+
                            \-------------<>| JnlpAdapter        |
                                            +--------------------+
  

The JnlpAdapter is only used for browser remote control, the permanent storage of the file position must be done by the caller, using get_newPosition() and get_newDigest().
ATTENTION some of the translation keys are defined by messages from "GetAndUnpackZipArchive".
(Created by extracting from bandm_book/.../book2/base/Gui.java,translations.muli and extending (checksum, etc).)

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JDialog

JDialog.AccessibleJDialog

Nested classes/interfaces inherited from class java.awt.Dialog

Dialog.AccessibleAWTDialog, Dialog.ModalExclusionType, Dialog.ModalityType

Nested classes/interfaces inherited from class java.awt.Window

Window.AccessibleAWTWindow, Window.Type

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

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

Field Summary

Fields

Modifier and Type	Field and Description
protected URL	browseUrl Deprecated.
protected byte[]	curDigest Deprecated.
protected File	curPosition Deprecated.
static String	defaultLang Deprecated.
protected String	DES_dir_name Deprecated.
protected String	docu_start_filename Deprecated.
protected URL	downloadUrl Deprecated.
protected JnlpAdapter	jnlpAdapter Deprecated.
protected CatalogByString	mulicat Deprecated.
protected byte[]	newDigest Deprecated.
protected File	newPosition Deprecated.
protected byte[]	oldDigest Deprecated.
protected File	oldPosition Deprecated.
protected File	selected_DES_Path Deprecated.
protected boolean	tampered Deprecated.

Fields inherited from class eu.bandm.tools.graficUtils.TextDialog

answer, defaultSize, DIGITS, epane, firstPara, hasShortcuts, icon, keylistener, lf, linklistener, nonSelectedLink, shortcutlist, stepNum

Fields inherited from class javax.swing.JDialog

accessibleContext, rootPane, rootPaneCheckingEnabled

Fields inherited from class java.awt.Dialog

DEFAULT_MODALITY_TYPE

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface javax.swing.WindowConstants

DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

Constructors

Constructor and Description
DownloadDialog_DeEn(JFrame frame, String title, String DES_dir_name, URL downloadUrl, URL browseUrl, String docu_start_filename, boolean modal, String lang, JnlpAdapter jnlpAdapter, File oldPosition, byte[] oldDigest, Dimension windowsize) Deprecated. After creation the (inherited) message runDialog() must be called.

Method Summary

Modifier and Type	Method and Description
protected void	appendAlternatives() Deprecated. Create text which describes the possible alternatives download/download anew browse online browse local IFF local loaded (implies jnlpmode !?!)
protected void	appendStatusText() Deprecated. Create text which describes the current information status, and which will appear as first.
protected String	closeDialogLink() Deprecated.
byte[]	get_newDigest() Deprecated. Is != null iff get_newPosition()!= null.
File	get_newPosition() Deprecated. Only set != null when a new position has been entered by the user and the download succeeded.
protected boolean	jnlpMode() Deprecated.
protected String	muli(String key, List<String> translations) Deprecated.
protected String	muli(String key, List<String> translations, Object... args) Deprecated.
protected String	muli(String key, String... pairs) Deprecated.
protected void	react() Deprecated. Reactions on situation/alterntive texts: answer = "download" ===> file chooser =======> result = abort ====> restart loop =======> result = selected ====> safety question =======> answer = cancel ====> restart loop =======> answer = okay ====> start download, iff okay, calculate new checksum, set values of curPosition, curDigest and tampered.

Methods inherited from class eu.bandm.tools.graficUtils.TextDialog

appendText, appendTextLine, finished, runDialog, transformLinks, wrapError, wrapTT

Methods inherited from class javax.swing.JDialog

addImpl, createRootPane, dialogInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getGraphics, getJMenuBar, getLayeredPane, getRootPane, getTransferHandler, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, repaint, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, setTransferHandler, update

Methods inherited from class java.awt.Dialog

addNotify, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setBackground, setModal, setModalityType, setOpacity, setResizable, setShape, setTitle, setUndecorated, setVisible, show, toBack

Methods inherited from class java.awt.Window

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, toFront

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

defaultLang

public static final String defaultLang

Deprecated.

See Also:

Constant Field Values

DES_dir_name

protected final String DES_dir_name

Deprecated.

downloadUrl

protected final URL downloadUrl

Deprecated.

browseUrl

protected final URL browseUrl

Deprecated.

docu_start_filename

protected final String docu_start_filename

Deprecated.

jnlpAdapter

protected final JnlpAdapter jnlpAdapter

Deprecated.

oldPosition

protected File oldPosition

Deprecated.

curPosition

protected File curPosition

Deprecated.

newPosition

protected File newPosition

Deprecated.

oldDigest

protected byte[] oldDigest

Deprecated.

curDigest

protected byte[] curDigest

Deprecated.

newDigest

protected byte[] newDigest

Deprecated.

tampered

protected boolean tampered

Deprecated.

mulicat

protected CatalogByString mulicat

Deprecated.

selected_DES_Path

protected File selected_DES_Path

Deprecated.

Constructor Detail

DownloadDialog_DeEn

public DownloadDialog_DeEn(JFrame frame,
                           String title,
                           String DES_dir_name,
                           URL downloadUrl,
                           URL browseUrl,
                           String docu_start_filename,
                           boolean modal,
                           String lang,
                           JnlpAdapter jnlpAdapter,
                           File oldPosition,
                           byte[] oldDigest,
                           Dimension windowsize)

Deprecated.

After creation the (inherited) message runDialog() must be called. This performs the dialog by calling "react()" etc.
The name of the class reflects the fact that languages "en" and "de" are supported. New languages can be added by subclassing

    d= new DownloadDialog_DeEn(....)
         {{mulicat.put("when opening url socket", 
                       "nl", "xx xx xx",
                           "fr", "xx xx xx");
           mulicat.put("when writing local file",
                       "nl", "xx xx xx",
                           "fr", "xx xx xx");
      }};
  

FIXME generate a file "downloadHistory" / "DOWNLOAD_STATUS" (english and selected language!)

Parameters:

frame - OPT, window of application, MAY be used by Swing for positioning, etc.

title - OPT, window title for dialog pop-up window

DES_dir_name - file name of the one(1) directory which will be created on the local machine for storing all Do+X+S-files This must be also the only(1) top-level dir in the installed zipfile. When for the position of download is asked, and a directory with this name is selected, than the effect is the same as if its parent were selected.

browseUrl - the url where the net browsing will start

docu_start_filename - file name of the entry point for local browsing, relative to the download position (something like "doc/user/index.html")

modal - whether the dialog is a modal one

lang - OPT preferred language, defaults to defaultLang.

jnlpAdapter - JnlpAdapter used for status report and start local browsing

oldPosition - OPT file position of previous, memorized download of Do+eX+S-files

oldDigest - OPT checksum for oldPosition. Both must be null, or not-null.

windowsize - OPT for the dialog window

Method Detail

get_newPosition

public File get_newPosition()

Deprecated.

Only set != null when a new position has been entered by the user and the download succeeded.

get_newDigest

public byte[] get_newDigest()

Deprecated.

Is != null iff get_newPosition()!= null.

jnlpMode

protected boolean jnlpMode()

Deprecated.

muli

protected String muli(String key,
                      List<String> translations,
                      Object... args)

Deprecated.

muli

protected String muli(String key,
                      List<String> translations)

Deprecated.

muli

protected String muli(String key,
                      String... pairs)

Deprecated.

appendStatusText

protected void appendStatusText()

Deprecated.

Create text which describes the current information status, and which will appear as first. Is only called ONCE(1), at the very beginning. First inquiry situation:
no persistent info
persistent info, but no old download
persistent info, old download, tampered with
persistent info, old download, unchanged

appendAlternatives

protected void appendAlternatives()

Deprecated.

Create text which describes the possible alternatives
download/download anew
browse online
browse local IFF local loaded (implies jnlpmode !?!)

closeDialogLink

protected String closeDialogLink()

Deprecated.

react

protected void react()

Deprecated.

Reactions on situation/alterntive texts:
answer = "download"
===> file chooser
=======> result = abort ====> restart loop
=======> result = selected ====> safety question
=======> answer = cancel ====> restart loop
=======> answer = okay ====> start download, iff okay, calculate new checksum, set values of curPosition, curDigest and tampered.


answer = "browseMet" "browseLocal"
===> jnlp not availaible or browser remote control failed ===> show text to load page manually
===> jnlp browser remote control returns okay ===> show text to end dialog

Overrides:

react in class TextDialog