UCopy ( Frame4J -- the Java framework de.frame4j... )

java.lang.Object
- de.frame4j.util.App
- - de.frame4j.UCopy

All Implemented Interfaces:

AttrSettable, TextHelper.MessageComponents, AppMBean, ComVar, UIInfo, ActionListener, EventListener
```
@MinDoc(copyright="Copyright 1997 - 2009, 2015  A. Weinert",
        author="Albrecht Weinert",
        version="V.44",
        lastModified="6.05.2021",
        usage="start as Java application (-? for help)",
        purpose="copy file or URL to file")
public class UCopy
extends App
```
Copy from file or URL to file.

This application copies from a file or an URL to an output file or to normal output. The source specification is understood as URL (e.g. "http(s)://www.xyz.de/apps/t.txt") and as file (e.g. "D:/uhu/tmp/edwin/t.txt"), treating both (comfortably) as equal (at command line / script level). File specifications will be used with the "correct" file separator (see ComVar.FS).

If the destination is a directory the source's filename will be used.

This tool fetches files from Internet, the download of which by "save link as" browsers may deny or not even offer.
To get files from the net an authentication (name, password) may be provided as well as proxy settings. Like with all Frame4J's (App inheritors) applications this may be done by command line or — with more comfort — by providing an extra .properties file.

On copying to a destination file the source's last modification date will be transfered (when possible) as the date of the copying usually being irrelevant.

The copying process is binary by default (byte by byte; one to one).
If different encodings are specified for source and destination two transformations to and from Unicode are inserted. The same applies if text transformations are ordered. In these cases only, source and destination file may be the same. This is ordered by just omitting the destination parameter.

Use cases for changing the the file encoding in situ are compilers that insist in just one source file encoding no matter which the platform and all other tools use and the platform independent deployment of text files in archives (like .properties in .jar).

The example of changing of a file's text encoding shows that the copy process by this tool is a good place for any sort of text manipulation. Those may be implemented by extending this class and just overriding the method manipContent(String) that will be intervened between reading and writing if textManip is not empty. If it is "eclipseDictionary" this class' implementation of manipContent(String) will
- separate word in single lines
- delete a trailing dot or comma
- delete single letters and doublets (also those distinguished by first capital only)
- delete words containing digits or upper case characters only.
That's just what's needed to bring a text containing correctly spelled word forms to the most simple form of a .dic file (dictionary) usable for Eclipse.

Hint: To this application UCopy belongs (as integral part) a .properties file named UCopy.properties. It's part of the documentation.
See also the hints in the package description.

© Copyright 1997 - 2003, 2005, 2007 Albrecht Weinert

Nested Class Summary
- Nested classes/interfaces inherited from interface de.frame4j.util.ComVar
  ComVar.Impl

Field Summary

Fields
Modifier and Type	Field and Description
`String`	`destination` Name of destination file or directory.
`String`	`inEncoding` The input's (text) encoding.
`String`	`name` User name with password (name:passw).
`String`	`outEncoding` The output's (text) encoding.
`String`	`proxyHost` Name of the proxy server.
`String`	`proxyPort` Port of the proxy server..
`boolean`	`proxySet` Use a proxy server when reading from URLs.
`String`	`source` Name of source file or source URL.
`String`	`textManip` Denomination of a text manipulation to be done while copying.

Fields inherited from class de.frame4j.util.App
ano, appBase, appIO, appStartTime, appStartTimeMS, args, argsOrig, bgColor, err, fullClassName, help, icon, log, mainThread, myClass, myFrame, out, outMode, packName, prop, retCode, runFlag, shortClassName, title, verbose, verbosity

Fields inherited from interface de.frame4j.util.ComVar
AUTHOR, BLANK_STRING, cons, CONSOL_ENCODING, COPYRIGHT, D, D_NaN, D_NegInf, D_PosInf, EMPTY_INT_A, EMPTY_STRING, FILE_ENCODING, FRW_CLLD, FS, FSS, H, hasCons, HOST_IP, HOST_IPv4, HOST_NAME, INIT_ERROR, JAR_ENCODING, JH, JOB_DONE_OK, JRL, LOG_OUT_ERROR, M, MAIN_THREAD_EXC, NO_BYTES, NO_CLASSES, NO_DOUBLES, NO_OBJECTS, NO_PARS_ERROR, NO_STRINGS, NOT_WINDOWS, ON_PI, ONE_DAY, ONE_HOUR, ONE_LEAP_YEAR, ONE_MINUTE, ONE_SECOND, ONE_WEEK, ONE_YEAR, OS, PROG_NAME, PROG_SHORT, PS, RUNTIME, S, SHY, UD, UL, UL_UR_da, UR

Fields inherited from interface de.frame4j.net.AttrSettable
ILLEGAL_TYPE, ILLEGAL_VALUE, NO_ATTRIBUTE, NO_KNOWN_ATTRIBUTE, NO_VALUE, OK, retVtext

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`int`	`doIt()` Working method of UCopy.
`static void`	`main(String[] args)` Start method of UCopy.
`protected String`	`manipContent(String content)` Optional text manipulation method.

Methods inherited from class de.frame4j.util.App
actionPerformed, allowNoPropertiesFile, clientOrder, condHelpLog, connect, errMeld, errMeld, errorExit, errorExit, errorText, extraPropertiesFile, formMessage, formMessage, formMessage, getAbout, getAboutText, getActTime, getAppLogger, getAppStartTime, getArgs, getAuthor, getCopyright, getDbLogger, getExecTimeMs, getExecTimeMsL, getExecTimeString, getHelp, getHelpText, getIcon, getLanguage, getLogHandler, getMessageComponent, getMessageComponentsLength, getMyFrame, getName, getNameWithVersDate, getOutMode, getProp, getPurpose, getStartTime, getStateString, getTheCloser, getTitle, getUsage, getVerbose, getVerbosity, getVersDate, go, go, go, haveIcon, isDebug, isHelp, isHelpLog, isNormal, isRunFlag, isSilent, isTest, isVerbose, logVerbose, logVerbose, makeStatusTextEnd, makeStatusTextStart, messageFormat, normalExit, parsePartial, performeAction, queueAction, regAsStdMBean, repExc, setAboutText, setAttribute, setAttribute, setAuthor, setBgColor, setCodePages, setCopyright, setHelp, setLogOut2, setName, setOutMode, setOutMode, setPurpose, setTitle, setUsage, setVerbose, setVerbose, setVerbosity, setVerbosity, setVersDate, stop, threeLineEndMsg, toString, twoLineEndMsg, twoLineStartMsg, valueLang, valueLang, wakeMainThread

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface de.frame4j.net.AttrSettable
retVtext

- Field Detail
  - source
```
public String source
```
    Name of source file or source URL.
  - destination
```
public String destination
```
    Name of destination file or directory.
  - textManip
```
public String textManip
```
    Denomination of a text manipulation to be done while copying.
    
    default: null = do nothing, except perhaps character coding changes
    possible values: null, "eclipseDictionary", .. ..
    
    See Also:
    
    manipContent(String), inEncoding, outEncoding
  - proxySet
```
public boolean proxySet
```
    Use a proxy server when reading from URLs.
    
    If true a proxy will be used and properties proxyHost and proxyHost take effect.
    
    default: true
  - proxyHost
```
public String proxyHost
```
    Name of the proxy server.
    
    default: cache
    
    See Also:
    
    proxySet
  - proxyPort
```
public String proxyPort
```
    Port of the proxy server..
    
    default: 8080
    
    See Also:
    
    proxySet
  - name
```
public String name
```
    User name with password (name:passw).
    
    default: no name.
  - inEncoding
```
public String inEncoding
```
    The input's (text) encoding.
    
    default: no encoding / binary
  - outEncoding
```
public String outEncoding
```
    The output's (text) encoding.
    
    default: no encoding / binary.
- Method Detail
  - main
```
public static void main(String[] args)
```
    Start method of UCopy.
    
    Execution is: java UCopy [options] source [destination]
    
    Parameters:
    
    args - command line arguments
    
    See Also:
    
    doIt(), App.go(String[])
  - manipContent
```
protected String manipContent(String content)
```
    Optional text manipulation method.
    
    If the property textManip is not empty this method is called between reading and writing the text content. It may do any optional content manipulation.
    This implementation will do the preparation of an (Eclipse) dictionary if textManip is "eclipseDictionary".
    
    In that case this implementation will
    - separate word in single lines
    - delete a trailing dot or comma
    - delete single letters and doublets (also those distinguished by first capital only)
    - delete words containing digits or upper case characters only.
    That is just what's needed to bring a text containing correctly spelled word forms to the most simple form of a .dic file (dictionary) usable for Eclipse.
    
    For all other values of textManip this implementation will return the content unchanged.
    Parameters:
    
    content - the original text content, null will return the empty String, no matter what textManip says
    
    Returns:
    
    content, modified
  - doIt
```
public int doIt()
```
    Working method of UCopy.
    
    Specified by:
    
    doIt in class App
    
    Returns:
    
    the exit code; 0 means OK
    
    See Also:
    
    main(String[]), App.go(String[])

Class UCopy

Nested Class Summary

Nested classes/interfaces inherited from interface de.frame4j.util.ComVar

Field Summary

Fields inherited from class de.frame4j.util.App

Fields inherited from interface de.frame4j.util.ComVar

Fields inherited from interface de.frame4j.net.AttrSettable

Method Summary

Methods inherited from class de.frame4j.util.App

Methods inherited from class java.lang.Object

Methods inherited from interface de.frame4j.net.AttrSettable

Field Detail

source

destination

textManip

proxySet

proxyHost

proxyPort

name

inEncoding

outEncoding

Method Detail

main

manipContent

doIt