Compare commits
264 Commits
gclc-1.2.4
...
swt-1.1.6
| Author | SHA1 | Date | |
|---|---|---|---|
| e1d030c6c5 | |||
| 8bc2b13a92 | |||
| c1050b1b4f | |||
| a3e4758d1b | |||
| c436b5af2f | |||
| 3272261be1 | |||
| f82f0b9f16 | |||
| 1fa9ca213e | |||
| 265f90526a | |||
| 71b325508f | |||
| 98857e425a | |||
| 8c6b1d8884 | |||
| 2972e82f4a | |||
| 0ab39b24f6 | |||
| 171f79518d | |||
| 0e422a81ce | |||
| ea4164fbfb | |||
| e2f45c77d9 | |||
| 55bb54ca43 | |||
| cf29eb37cc | |||
| 579e85dcb3 | |||
| 7e36a378c4 | |||
| 80242c79e8 | |||
| ab9a4c474b | |||
| b8e5ea0b78 | |||
| 2637d99bce | |||
| cfd3450afe | |||
| 20d5a84269 | |||
| 637cfb8f43 | |||
| d7fbdfb66b | |||
| 22741104f5 | |||
| 45c5375118 | |||
| d01b1608f3 | |||
| 674333a42c | |||
| af0c8e91f8 | |||
| 461dec8894 | |||
| f590542b3f | |||
| c21517a53d | |||
| 7e3b727024 | |||
| bd5b67c312 | |||
| 216cd41dc8 | |||
| 1df33afdbe | |||
| 8d51733590 | |||
| d49a2474e0 | |||
| d7ecd75678 | |||
| 31ad72567a | |||
| 99134c1831 | |||
| dc988a07ac | |||
| 4d31bbacbf | |||
| 2145473706 | |||
| 3f8cee20e1 | |||
| 977c9a8ec8 | |||
| 889433d800 | |||
| 89847738e5 | |||
| cd76d438c1 | |||
| fa46939c54 | |||
| fe4851053a | |||
| 6a7d0b11a0 | |||
| 93589c750e | |||
| c23af20b17 | |||
| c7625c8006 | |||
| ad65165169 | |||
| 0814ab5740 | |||
| ba26a70daa | |||
| 4301f2a15e | |||
| 2a05366e31 | |||
| bd44b5bf85 | |||
| 4e804325e6 | |||
| ae5dc1aeba | |||
| d5a7d4a16f | |||
| de593c00a1 | |||
| 50ac6eec06 | |||
| 74c66dcbdd | |||
| 7c94dea7b5 | |||
| a580133945 | |||
| 38fe457f47 | |||
| 159805701c | |||
| f7876dc964 | |||
| c4db9f43fb | |||
| 67abd91f72 | |||
| 7934ab7435 | |||
| 761d640f0b | |||
| 98d22782c1 | |||
| f8da1c0119 | |||
| 438727e7b9 | |||
| a2a87eb0d7 | |||
| 7ba8b38624 | |||
| 6bcf2b0c91 | |||
| 3a568d3723 | |||
| 7e81105785 | |||
| bb7c01a7f2 | |||
| d3064f18b6 | |||
| 7a7bf0b019 | |||
| a69c4a777f | |||
| bf50a4eaa4 | |||
| fda1bad1c7 | |||
| a585414982 | |||
| e8cf6eb68f | |||
| afb773636f | |||
| a999d5f55b | |||
| c97c8735eb | |||
| 0ce31ff752 | |||
| c433175aa5 | |||
| a368e21668 | |||
| e6b4766d89 | |||
| dd3072615a | |||
| d3c1a55a41 | |||
| 5d8d7b23ea | |||
| 383ba0e702 | |||
| 0bb2103f85 | |||
| 3bed05c53f | |||
| 27bc7cc07b | |||
| c83a598abb | |||
| 829445bf74 | |||
| 02ea720bb9 | |||
| 41c9c9cd0d | |||
| d99d97b9d5 | |||
| c8745e00a9 | |||
| 8ca2905b2a | |||
| 37cbe2eb95 | |||
| 9bc46c93a6 | |||
| 00c0e86d72 | |||
| eae7e0d69f | |||
| 926a8d72fa | |||
| 95ec674528 | |||
| 4d30402a42 | |||
| cdcf9f0fae | |||
| cce8a9504d | |||
| 119afe1660 | |||
| 7517251d1c | |||
| f8a37e7eee | |||
| 3598bb359e | |||
| e9fa6e209f | |||
| d4b695f60b | |||
| 8a8d298485 | |||
| 50887f44bb | |||
| 3a5250d987 | |||
| ddc60652f1 | |||
| 206df88506 | |||
| d2cd059c01 | |||
| 90dab5a809 | |||
| d5f2d39808 | |||
| 36f39df87e | |||
| 82e8d1e1b7 | |||
| 0ebcd7b210 | |||
| d32ea6b4b0 | |||
| e5d5edcf63 | |||
| b80a3fc5b8 | |||
| 6bb937342e | |||
| 283090d361 | |||
| 83c02f82ec | |||
| fce2b01914 | |||
| 9b071a378f | |||
| 89e849c27f | |||
| 9747cf21b2 | |||
| 6f8c536f55 | |||
| b3224ad689 | |||
| 0feb069878 | |||
| b5f1463864 | |||
| 0bbe9d321d | |||
| 2e28e269e1 | |||
| e11d90378f | |||
| 6a0e68d312 | |||
| 3534e817e2 | |||
| 20193dd1e4 | |||
| 5df8321dee | |||
| 629d07bc32 | |||
| e32e2428e5 | |||
| db9f81c6a8 | |||
| 0a995394f9 | |||
| 0ca055db8e | |||
| b93c2b5220 | |||
| 8322454f72 | |||
| ab47d6573b | |||
| 6d496d701d | |||
| b4df39491e | |||
| 775a71b2ec | |||
| c9eb221d31 | |||
| 340a0317af | |||
| 35959a8d8a | |||
| 07645d7c0c | |||
| 99c0c9008b | |||
| 26265ad7e6 | |||
| 092883f4c3 | |||
| 25904c907d | |||
| ae55ebea29 | |||
| e989aff2f4 | |||
| 2f0c03a73b | |||
| ff9ace1033 | |||
| ffa54af3be | |||
| 269704f5a2 | |||
| aecc18cc83 | |||
| 063cad61cd | |||
| 201b6ad366 | |||
| bf8d76750f | |||
| 17ac47f15e | |||
| 7de2dadbe0 | |||
| 50395ba852 | |||
| 248c82cf50 | |||
| 6289ca1db9 | |||
| 5b6634eaf0 | |||
| 4737a16874 | |||
| bf0a3b30e5 | |||
| 5d25971b56 | |||
| c27872de94 | |||
| a12484a72a | |||
| ee0d91e455 | |||
| 719d7ada3f | |||
| c877450b2b | |||
| f3a8aafce1 | |||
| d2bc86fffc | |||
| 3b6ba337f1 | |||
| 6a117afcb3 | |||
| 7d41a9f4c6 | |||
| 90579d79a9 | |||
| b2c98ae940 | |||
| 1d6569cf69 | |||
| 072653c944 | |||
| ad17c7d5d7 | |||
| e469313baf | |||
| 543b1ef605 | |||
| 24f1fba97e | |||
| 88fe564e24 | |||
| efa492570e | |||
| d07795cb6a | |||
| f3c3580855 | |||
| 62f59722a6 | |||
| 3e31a38eb9 | |||
| 549ddc3e6f | |||
| d300e896e8 | |||
| 16514f9c25 | |||
| bb9f9c515b | |||
| 77c5ae64dd | |||
| 18c7f89564 | |||
| 5f185b52e9 | |||
| 2f5ea369b7 | |||
| ef708c3291 | |||
| 9e040d80c4 | |||
| e3ced7b961 | |||
| c9b2270786 | |||
| 99ebb23138 | |||
| d4f428d311 | |||
| e602a269f8 | |||
| d432914828 | |||
| 0cf54c4837 | |||
| c1692019a6 | |||
| 72362936be | |||
| 65b6be8283 | |||
| fd8dde32f1 | |||
| fff9f4ea74 | |||
| 9e5d8c4ca4 | |||
| a70be63894 | |||
| c2fa0f2c0b | |||
| 5280ee98bd | |||
| 1a207c8100 | |||
| 80d10d7d85 | |||
| ecc10994ca | |||
| 7289fc12ad | |||
| f44366ff05 | |||
| 70a71c06a7 | |||
| a0202de532 | |||
| caa00f2a61 | |||
| eed6f43aea | |||
| 59ab689a36 |
65
Jenkinsfile
vendored
Normal file
65
Jenkinsfile
vendored
Normal file
@@ -0,0 +1,65 @@
|
|||||||
|
pipeline {
|
||||||
|
agent any
|
||||||
|
stages {
|
||||||
|
stage('Site GCLC') {
|
||||||
|
when {
|
||||||
|
tag "gclc-*"
|
||||||
|
}
|
||||||
|
steps {
|
||||||
|
dir('gclc') {
|
||||||
|
sh 'mvn site:site'
|
||||||
|
sh 'mkdir -p /home/maven-sites/net/bigeon/gclc'
|
||||||
|
sh 'cp -r target/site /home/maven-sites/net/bigeon/gclc/gclc'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
stage('Site GCLC-Socket') {
|
||||||
|
when {
|
||||||
|
tag "socket-*"
|
||||||
|
}
|
||||||
|
steps {
|
||||||
|
dir('gclc-socket') {
|
||||||
|
sh 'mvn site:site'
|
||||||
|
sh 'mkdir -p /home/maven-sites/net/bigeon/gclc'
|
||||||
|
sh 'cp -r target/site /home/maven-sites/net/bigeon/gclc/gclc-socket'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
stage('Site GCLC-Swt') {
|
||||||
|
when {
|
||||||
|
tag "swt-*"
|
||||||
|
}
|
||||||
|
steps {
|
||||||
|
dir('gclc-swt') {
|
||||||
|
sh 'mvn site:site'
|
||||||
|
sh 'mkdir -p /home/maven-sites/net/bigeon/gclc'
|
||||||
|
sh 'cp -r target/site /home/maven-sites/net/bigeon/gclc/gclc-swt'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
stage('Site GCLC-Processes') {
|
||||||
|
when {
|
||||||
|
tag "process-*"
|
||||||
|
}
|
||||||
|
steps {
|
||||||
|
dir('gclc-process') {
|
||||||
|
sh 'mvn site:site'
|
||||||
|
sh 'mkdir -p /home/maven-sites/net/bigeon/gclc'
|
||||||
|
sh 'cp -r target/site /home/maven-sites/net/bigeon/gclc/gclc-process'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
stage('Site GCLC-System') {
|
||||||
|
when {
|
||||||
|
tag "system-*"
|
||||||
|
}
|
||||||
|
steps {
|
||||||
|
dir('gclc.system') {
|
||||||
|
sh 'mvn site:site'
|
||||||
|
sh 'mkdir -p /home/maven-sites/net/bigeon/gclc'
|
||||||
|
sh 'cp -r target/site /home/maven-sites/net/bigeon/gclc/gclc-system'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
4
gclc-process/.gitignore
vendored
Normal file
4
gclc-process/.gitignore
vendored
Normal file
@@ -0,0 +1,4 @@
|
|||||||
|
/target/
|
||||||
|
/.classpath
|
||||||
|
/.project
|
||||||
|
/.settings/
|
||||||
517
gclc-process/LICENSE.txt
Normal file
517
gclc-process/LICENSE.txt
Normal file
@@ -0,0 +1,517 @@
|
|||||||
|
CeCILL FREE SOFTWARE LICENSE AGREEMENT
|
||||||
|
|
||||||
|
Version 2.1 dated 2013-06-21
|
||||||
|
|
||||||
|
|
||||||
|
Notice
|
||||||
|
|
||||||
|
This Agreement is a Free Software license agreement that is the result
|
||||||
|
of discussions between its authors in order to ensure compliance with
|
||||||
|
the two main principles guiding its drafting:
|
||||||
|
|
||||||
|
* firstly, compliance with the principles governing the distribution
|
||||||
|
of Free Software: access to source code, broad rights granted to users,
|
||||||
|
* secondly, the election of a governing law, French law, with which it
|
||||||
|
is conformant, both as regards the law of torts and intellectual
|
||||||
|
property law, and the protection that it offers to both authors and
|
||||||
|
holders of the economic rights over software.
|
||||||
|
|
||||||
|
The authors of the CeCILL (for Ce[a] C[nrs] I[nria] L[ogiciel] L[ibre])
|
||||||
|
license are:
|
||||||
|
|
||||||
|
Commissariat à l'énergie atomique et aux énergies alternatives - CEA, a
|
||||||
|
public scientific, technical and industrial research establishment,
|
||||||
|
having its principal place of business at 25 rue Leblanc, immeuble Le
|
||||||
|
Ponant D, 75015 Paris, France.
|
||||||
|
|
||||||
|
Centre National de la Recherche Scientifique - CNRS, a public scientific
|
||||||
|
and technological establishment, having its principal place of business
|
||||||
|
at 3 rue Michel-Ange, 75794 Paris cedex 16, France.
|
||||||
|
|
||||||
|
Institut National de Recherche en Informatique et en Automatique -
|
||||||
|
Inria, a public scientific and technological establishment, having its
|
||||||
|
principal place of business at Domaine de Voluceau, Rocquencourt, BP
|
||||||
|
105, 78153 Le Chesnay cedex, France.
|
||||||
|
|
||||||
|
|
||||||
|
Preamble
|
||||||
|
|
||||||
|
The purpose of this Free Software license agreement is to grant users
|
||||||
|
the right to modify and redistribute the software governed by this
|
||||||
|
license within the framework of an open source distribution model.
|
||||||
|
|
||||||
|
The exercising of this right is conditional upon certain obligations for
|
||||||
|
users so as to preserve this status for all subsequent redistributions.
|
||||||
|
|
||||||
|
In consideration of access to the source code and the rights to copy,
|
||||||
|
modify and redistribute granted by the license, users are provided only
|
||||||
|
with a limited warranty and the software's author, the holder of the
|
||||||
|
economic rights, and the successive licensors only have limited liability.
|
||||||
|
|
||||||
|
In this respect, the risks associated with loading, using, modifying
|
||||||
|
and/or developing or reproducing the software by the user are brought to
|
||||||
|
the user's attention, given its Free Software status, which may make it
|
||||||
|
complicated to use, with the result that its use is reserved for
|
||||||
|
developers and experienced professionals having in-depth computer
|
||||||
|
knowledge. Users are therefore encouraged to load and test the
|
||||||
|
suitability of the software as regards their requirements in conditions
|
||||||
|
enabling the security of their systems and/or data to be ensured and,
|
||||||
|
more generally, to use and operate it in the same conditions of
|
||||||
|
security. This Agreement may be freely reproduced and published,
|
||||||
|
provided it is not altered, and that no provisions are either added or
|
||||||
|
removed herefrom.
|
||||||
|
|
||||||
|
This Agreement may apply to any or all software for which the holder of
|
||||||
|
the economic rights decides to submit the use thereof to its provisions.
|
||||||
|
|
||||||
|
Frequently asked questions can be found on the official website of the
|
||||||
|
CeCILL licenses family (http://www.cecill.info/index.en.html) for any
|
||||||
|
necessary clarification.
|
||||||
|
|
||||||
|
|
||||||
|
Article 1 - DEFINITIONS
|
||||||
|
|
||||||
|
For the purpose of this Agreement, when the following expressions
|
||||||
|
commence with a capital letter, they shall have the following meaning:
|
||||||
|
|
||||||
|
Agreement: means this license agreement, and its possible subsequent
|
||||||
|
versions and annexes.
|
||||||
|
|
||||||
|
Software: means the software in its Object Code and/or Source Code form
|
||||||
|
and, where applicable, its documentation, "as is" when the Licensee
|
||||||
|
accepts the Agreement.
|
||||||
|
|
||||||
|
Initial Software: means the Software in its Source Code and possibly its
|
||||||
|
Object Code form and, where applicable, its documentation, "as is" when
|
||||||
|
it is first distributed under the terms and conditions of the Agreement.
|
||||||
|
|
||||||
|
Modified Software: means the Software modified by at least one
|
||||||
|
Contribution.
|
||||||
|
|
||||||
|
Source Code: means all the Software's instructions and program lines to
|
||||||
|
which access is required so as to modify the Software.
|
||||||
|
|
||||||
|
Object Code: means the binary files originating from the compilation of
|
||||||
|
the Source Code.
|
||||||
|
|
||||||
|
Holder: means the holder(s) of the economic rights over the Initial
|
||||||
|
Software.
|
||||||
|
|
||||||
|
Licensee: means the Software user(s) having accepted the Agreement.
|
||||||
|
|
||||||
|
Contributor: means a Licensee having made at least one Contribution.
|
||||||
|
|
||||||
|
Licensor: means the Holder, or any other individual or legal entity, who
|
||||||
|
distributes the Software under the Agreement.
|
||||||
|
|
||||||
|
Contribution: means any or all modifications, corrections, translations,
|
||||||
|
adaptations and/or new functions integrated into the Software by any or
|
||||||
|
all Contributors, as well as any or all Internal Modules.
|
||||||
|
|
||||||
|
Module: means a set of sources files including their documentation that
|
||||||
|
enables supplementary functions or services in addition to those offered
|
||||||
|
by the Software.
|
||||||
|
|
||||||
|
External Module: means any or all Modules, not derived from the
|
||||||
|
Software, so that this Module and the Software run in separate address
|
||||||
|
spaces, with one calling the other when they are run.
|
||||||
|
|
||||||
|
Internal Module: means any or all Module, connected to the Software so
|
||||||
|
that they both execute in the same address space.
|
||||||
|
|
||||||
|
GNU GPL: means the GNU General Public License version 2 or any
|
||||||
|
subsequent version, as published by the Free Software Foundation Inc.
|
||||||
|
|
||||||
|
GNU Affero GPL: means the GNU Affero General Public License version 3 or
|
||||||
|
any subsequent version, as published by the Free Software Foundation Inc.
|
||||||
|
|
||||||
|
EUPL: means the European Union Public License version 1.1 or any
|
||||||
|
subsequent version, as published by the European Commission.
|
||||||
|
|
||||||
|
Parties: mean both the Licensee and the Licensor.
|
||||||
|
|
||||||
|
These expressions may be used both in singular and plural form.
|
||||||
|
|
||||||
|
|
||||||
|
Article 2 - PURPOSE
|
||||||
|
|
||||||
|
The purpose of the Agreement is the grant by the Licensor to the
|
||||||
|
Licensee of a non-exclusive, transferable and worldwide license for the
|
||||||
|
Software as set forth in Article 5 <#scope> hereinafter for the whole
|
||||||
|
term of the protection granted by the rights over said Software.
|
||||||
|
|
||||||
|
|
||||||
|
Article 3 - ACCEPTANCE
|
||||||
|
|
||||||
|
3.1 The Licensee shall be deemed as having accepted the terms and
|
||||||
|
conditions of this Agreement upon the occurrence of the first of the
|
||||||
|
following events:
|
||||||
|
|
||||||
|
* (i) loading the Software by any or all means, notably, by
|
||||||
|
downloading from a remote server, or by loading from a physical medium;
|
||||||
|
* (ii) the first time the Licensee exercises any of the rights granted
|
||||||
|
hereunder.
|
||||||
|
|
||||||
|
3.2 One copy of the Agreement, containing a notice relating to the
|
||||||
|
characteristics of the Software, to the limited warranty, and to the
|
||||||
|
fact that its use is restricted to experienced users has been provided
|
||||||
|
to the Licensee prior to its acceptance as set forth in Article 3.1
|
||||||
|
<#accepting> hereinabove, and the Licensee hereby acknowledges that it
|
||||||
|
has read and understood it.
|
||||||
|
|
||||||
|
|
||||||
|
Article 4 - EFFECTIVE DATE AND TERM
|
||||||
|
|
||||||
|
|
||||||
|
4.1 EFFECTIVE DATE
|
||||||
|
|
||||||
|
The Agreement shall become effective on the date when it is accepted by
|
||||||
|
the Licensee as set forth in Article 3.1 <#accepting>.
|
||||||
|
|
||||||
|
|
||||||
|
4.2 TERM
|
||||||
|
|
||||||
|
The Agreement shall remain in force for the entire legal term of
|
||||||
|
protection of the economic rights over the Software.
|
||||||
|
|
||||||
|
|
||||||
|
Article 5 - SCOPE OF RIGHTS GRANTED
|
||||||
|
|
||||||
|
The Licensor hereby grants to the Licensee, who accepts, the following
|
||||||
|
rights over the Software for any or all use, and for the term of the
|
||||||
|
Agreement, on the basis of the terms and conditions set forth hereinafter.
|
||||||
|
|
||||||
|
Besides, if the Licensor owns or comes to own one or more patents
|
||||||
|
protecting all or part of the functions of the Software or of its
|
||||||
|
components, the Licensor undertakes not to enforce the rights granted by
|
||||||
|
these patents against successive Licensees using, exploiting or
|
||||||
|
modifying the Software. If these patents are transferred, the Licensor
|
||||||
|
undertakes to have the transferees subscribe to the obligations set
|
||||||
|
forth in this paragraph.
|
||||||
|
|
||||||
|
|
||||||
|
5.1 RIGHT OF USE
|
||||||
|
|
||||||
|
The Licensee is authorized to use the Software, without any limitation
|
||||||
|
as to its fields of application, with it being hereinafter specified
|
||||||
|
that this comprises:
|
||||||
|
|
||||||
|
1. permanent or temporary reproduction of all or part of the Software
|
||||||
|
by any or all means and in any or all form.
|
||||||
|
|
||||||
|
2. loading, displaying, running, or storing the Software on any or all
|
||||||
|
medium.
|
||||||
|
|
||||||
|
3. entitlement to observe, study or test its operation so as to
|
||||||
|
determine the ideas and principles behind any or all constituent
|
||||||
|
elements of said Software. This shall apply when the Licensee
|
||||||
|
carries out any or all loading, displaying, running, transmission or
|
||||||
|
storage operation as regards the Software, that it is entitled to
|
||||||
|
carry out hereunder.
|
||||||
|
|
||||||
|
|
||||||
|
5.2 ENTITLEMENT TO MAKE CONTRIBUTIONS
|
||||||
|
|
||||||
|
The right to make Contributions includes the right to translate, adapt,
|
||||||
|
arrange, or make any or all modifications to the Software, and the right
|
||||||
|
to reproduce the resulting software.
|
||||||
|
|
||||||
|
The Licensee is authorized to make any or all Contributions to the
|
||||||
|
Software provided that it includes an explicit notice that it is the
|
||||||
|
author of said Contribution and indicates the date of the creation thereof.
|
||||||
|
|
||||||
|
|
||||||
|
5.3 RIGHT OF DISTRIBUTION
|
||||||
|
|
||||||
|
In particular, the right of distribution includes the right to publish,
|
||||||
|
transmit and communicate the Software to the general public on any or
|
||||||
|
all medium, and by any or all means, and the right to market, either in
|
||||||
|
consideration of a fee, or free of charge, one or more copies of the
|
||||||
|
Software by any means.
|
||||||
|
|
||||||
|
The Licensee is further authorized to distribute copies of the modified
|
||||||
|
or unmodified Software to third parties according to the terms and
|
||||||
|
conditions set forth hereinafter.
|
||||||
|
|
||||||
|
|
||||||
|
5.3.1 DISTRIBUTION OF SOFTWARE WITHOUT MODIFICATION
|
||||||
|
|
||||||
|
The Licensee is authorized to distribute true copies of the Software in
|
||||||
|
Source Code or Object Code form, provided that said distribution
|
||||||
|
complies with all the provisions of the Agreement and is accompanied by:
|
||||||
|
|
||||||
|
1. a copy of the Agreement,
|
||||||
|
|
||||||
|
2. a notice relating to the limitation of both the Licensor's warranty
|
||||||
|
and liability as set forth in Articles 8 and 9,
|
||||||
|
|
||||||
|
and that, in the event that only the Object Code of the Software is
|
||||||
|
redistributed, the Licensee allows effective access to the full Source
|
||||||
|
Code of the Software for a period of at least three years from the
|
||||||
|
distribution of the Software, it being understood that the additional
|
||||||
|
acquisition cost of the Source Code shall not exceed the cost of the
|
||||||
|
data transfer.
|
||||||
|
|
||||||
|
|
||||||
|
5.3.2 DISTRIBUTION OF MODIFIED SOFTWARE
|
||||||
|
|
||||||
|
When the Licensee makes a Contribution to the Software, the terms and
|
||||||
|
conditions for the distribution of the resulting Modified Software
|
||||||
|
become subject to all the provisions of this Agreement.
|
||||||
|
|
||||||
|
The Licensee is authorized to distribute the Modified Software, in
|
||||||
|
source code or object code form, provided that said distribution
|
||||||
|
complies with all the provisions of the Agreement and is accompanied by:
|
||||||
|
|
||||||
|
1. a copy of the Agreement,
|
||||||
|
|
||||||
|
2. a notice relating to the limitation of both the Licensor's warranty
|
||||||
|
and liability as set forth in Articles 8 and 9,
|
||||||
|
|
||||||
|
and, in the event that only the object code of the Modified Software is
|
||||||
|
redistributed,
|
||||||
|
|
||||||
|
3. a note stating the conditions of effective access to the full source
|
||||||
|
code of the Modified Software for a period of at least three years
|
||||||
|
from the distribution of the Modified Software, it being understood
|
||||||
|
that the additional acquisition cost of the source code shall not
|
||||||
|
exceed the cost of the data transfer.
|
||||||
|
|
||||||
|
|
||||||
|
5.3.3 DISTRIBUTION OF EXTERNAL MODULES
|
||||||
|
|
||||||
|
When the Licensee has developed an External Module, the terms and
|
||||||
|
conditions of this Agreement do not apply to said External Module, that
|
||||||
|
may be distributed under a separate license agreement.
|
||||||
|
|
||||||
|
|
||||||
|
5.3.4 COMPATIBILITY WITH OTHER LICENSES
|
||||||
|
|
||||||
|
The Licensee can include a code that is subject to the provisions of one
|
||||||
|
of the versions of the GNU GPL, GNU Affero GPL and/or EUPL in the
|
||||||
|
Modified or unmodified Software, and distribute that entire code under
|
||||||
|
the terms of the same version of the GNU GPL, GNU Affero GPL and/or EUPL.
|
||||||
|
|
||||||
|
The Licensee can include the Modified or unmodified Software in a code
|
||||||
|
that is subject to the provisions of one of the versions of the GNU GPL,
|
||||||
|
GNU Affero GPL and/or EUPL and distribute that entire code under the
|
||||||
|
terms of the same version of the GNU GPL, GNU Affero GPL and/or EUPL.
|
||||||
|
|
||||||
|
|
||||||
|
Article 6 - INTELLECTUAL PROPERTY
|
||||||
|
|
||||||
|
|
||||||
|
6.1 OVER THE INITIAL SOFTWARE
|
||||||
|
|
||||||
|
The Holder owns the economic rights over the Initial Software. Any or
|
||||||
|
all use of the Initial Software is subject to compliance with the terms
|
||||||
|
and conditions under which the Holder has elected to distribute its work
|
||||||
|
and no one shall be entitled to modify the terms and conditions for the
|
||||||
|
distribution of said Initial Software.
|
||||||
|
|
||||||
|
The Holder undertakes that the Initial Software will remain ruled at
|
||||||
|
least by this Agreement, for the duration set forth in Article 4.2 <#term>.
|
||||||
|
|
||||||
|
|
||||||
|
6.2 OVER THE CONTRIBUTIONS
|
||||||
|
|
||||||
|
The Licensee who develops a Contribution is the owner of the
|
||||||
|
intellectual property rights over this Contribution as defined by
|
||||||
|
applicable law.
|
||||||
|
|
||||||
|
|
||||||
|
6.3 OVER THE EXTERNAL MODULES
|
||||||
|
|
||||||
|
The Licensee who develops an External Module is the owner of the
|
||||||
|
intellectual property rights over this External Module as defined by
|
||||||
|
applicable law and is free to choose the type of agreement that shall
|
||||||
|
govern its distribution.
|
||||||
|
|
||||||
|
|
||||||
|
6.4 JOINT PROVISIONS
|
||||||
|
|
||||||
|
The Licensee expressly undertakes:
|
||||||
|
|
||||||
|
1. not to remove, or modify, in any manner, the intellectual property
|
||||||
|
notices attached to the Software;
|
||||||
|
|
||||||
|
2. to reproduce said notices, in an identical manner, in the copies of
|
||||||
|
the Software modified or not.
|
||||||
|
|
||||||
|
The Licensee undertakes not to directly or indirectly infringe the
|
||||||
|
intellectual property rights on the Software of the Holder and/or
|
||||||
|
Contributors, and to take, where applicable, vis-à-vis its staff, any
|
||||||
|
and all measures required to ensure respect of said intellectual
|
||||||
|
property rights of the Holder and/or Contributors.
|
||||||
|
|
||||||
|
|
||||||
|
Article 7 - RELATED SERVICES
|
||||||
|
|
||||||
|
7.1 Under no circumstances shall the Agreement oblige the Licensor to
|
||||||
|
provide technical assistance or maintenance services for the Software.
|
||||||
|
|
||||||
|
However, the Licensor is entitled to offer this type of services. The
|
||||||
|
terms and conditions of such technical assistance, and/or such
|
||||||
|
maintenance, shall be set forth in a separate instrument. Only the
|
||||||
|
Licensor offering said maintenance and/or technical assistance services
|
||||||
|
shall incur liability therefor.
|
||||||
|
|
||||||
|
7.2 Similarly, any Licensor is entitled to offer to its licensees, under
|
||||||
|
its sole responsibility, a warranty, that shall only be binding upon
|
||||||
|
itself, for the redistribution of the Software and/or the Modified
|
||||||
|
Software, under terms and conditions that it is free to decide. Said
|
||||||
|
warranty, and the financial terms and conditions of its application,
|
||||||
|
shall be subject of a separate instrument executed between the Licensor
|
||||||
|
and the Licensee.
|
||||||
|
|
||||||
|
|
||||||
|
Article 8 - LIABILITY
|
||||||
|
|
||||||
|
8.1 Subject to the provisions of Article 8.2, the Licensee shall be
|
||||||
|
entitled to claim compensation for any direct loss it may have suffered
|
||||||
|
from the Software as a result of a fault on the part of the relevant
|
||||||
|
Licensor, subject to providing evidence thereof.
|
||||||
|
|
||||||
|
8.2 The Licensor's liability is limited to the commitments made under
|
||||||
|
this Agreement and shall not be incurred as a result of in particular:
|
||||||
|
(i) loss due the Licensee's total or partial failure to fulfill its
|
||||||
|
obligations, (ii) direct or consequential loss that is suffered by the
|
||||||
|
Licensee due to the use or performance of the Software, and (iii) more
|
||||||
|
generally, any consequential loss. In particular the Parties expressly
|
||||||
|
agree that any or all pecuniary or business loss (i.e. loss of data,
|
||||||
|
loss of profits, operating loss, loss of customers or orders,
|
||||||
|
opportunity cost, any disturbance to business activities) or any or all
|
||||||
|
legal proceedings instituted against the Licensee by a third party,
|
||||||
|
shall constitute consequential loss and shall not provide entitlement to
|
||||||
|
any or all compensation from the Licensor.
|
||||||
|
|
||||||
|
|
||||||
|
Article 9 - WARRANTY
|
||||||
|
|
||||||
|
9.1 The Licensee acknowledges that the scientific and technical
|
||||||
|
state-of-the-art when the Software was distributed did not enable all
|
||||||
|
possible uses to be tested and verified, nor for the presence of
|
||||||
|
possible defects to be detected. In this respect, the Licensee's
|
||||||
|
attention has been drawn to the risks associated with loading, using,
|
||||||
|
modifying and/or developing and reproducing the Software which are
|
||||||
|
reserved for experienced users.
|
||||||
|
|
||||||
|
The Licensee shall be responsible for verifying, by any or all means,
|
||||||
|
the suitability of the product for its requirements, its good working
|
||||||
|
order, and for ensuring that it shall not cause damage to either persons
|
||||||
|
or properties.
|
||||||
|
|
||||||
|
9.2 The Licensor hereby represents, in good faith, that it is entitled
|
||||||
|
to grant all the rights over the Software (including in particular the
|
||||||
|
rights set forth in Article 5 <#scope>).
|
||||||
|
|
||||||
|
9.3 The Licensee acknowledges that the Software is supplied "as is" by
|
||||||
|
the Licensor without any other express or tacit warranty, other than
|
||||||
|
that provided for in Article 9.2 <#good-faith> and, in particular,
|
||||||
|
without any warranty as to its commercial value, its secured, safe,
|
||||||
|
innovative or relevant nature.
|
||||||
|
|
||||||
|
Specifically, the Licensor does not warrant that the Software is free
|
||||||
|
from any error, that it will operate without interruption, that it will
|
||||||
|
be compatible with the Licensee's own equipment and software
|
||||||
|
configuration, nor that it will meet the Licensee's requirements.
|
||||||
|
|
||||||
|
9.4 The Licensor does not either expressly or tacitly warrant that the
|
||||||
|
Software does not infringe any third party intellectual property right
|
||||||
|
relating to a patent, software or any other property right. Therefore,
|
||||||
|
the Licensor disclaims any and all liability towards the Licensee
|
||||||
|
arising out of any or all proceedings for infringement that may be
|
||||||
|
instituted in respect of the use, modification and redistribution of the
|
||||||
|
Software. Nevertheless, should such proceedings be instituted against
|
||||||
|
the Licensee, the Licensor shall provide it with technical and legal
|
||||||
|
expertise for its defense. Such technical and legal expertise shall be
|
||||||
|
decided on a case-by-case basis between the relevant Licensor and the
|
||||||
|
Licensee pursuant to a memorandum of understanding. The Licensor
|
||||||
|
disclaims any and all liability as regards the Licensee's use of the
|
||||||
|
name of the Software. No warranty is given as regards the existence of
|
||||||
|
prior rights over the name of the Software or as regards the existence
|
||||||
|
of a trademark.
|
||||||
|
|
||||||
|
|
||||||
|
Article 10 - TERMINATION
|
||||||
|
|
||||||
|
10.1 In the event of a breach by the Licensee of its obligations
|
||||||
|
hereunder, the Licensor may automatically terminate this Agreement
|
||||||
|
thirty (30) days after notice has been sent to the Licensee and has
|
||||||
|
remained ineffective.
|
||||||
|
|
||||||
|
10.2 A Licensee whose Agreement is terminated shall no longer be
|
||||||
|
authorized to use, modify or distribute the Software. However, any
|
||||||
|
licenses that it may have granted prior to termination of the Agreement
|
||||||
|
shall remain valid subject to their having been granted in compliance
|
||||||
|
with the terms and conditions hereof.
|
||||||
|
|
||||||
|
|
||||||
|
Article 11 - MISCELLANEOUS
|
||||||
|
|
||||||
|
|
||||||
|
11.1 EXCUSABLE EVENTS
|
||||||
|
|
||||||
|
Neither Party shall be liable for any or all delay, or failure to
|
||||||
|
perform the Agreement, that may be attributable to an event of force
|
||||||
|
majeure, an act of God or an outside cause, such as defective
|
||||||
|
functioning or interruptions of the electricity or telecommunications
|
||||||
|
networks, network paralysis following a virus attack, intervention by
|
||||||
|
government authorities, natural disasters, water damage, earthquakes,
|
||||||
|
fire, explosions, strikes and labor unrest, war, etc.
|
||||||
|
|
||||||
|
11.2 Any failure by either Party, on one or more occasions, to invoke
|
||||||
|
one or more of the provisions hereof, shall under no circumstances be
|
||||||
|
interpreted as being a waiver by the interested Party of its right to
|
||||||
|
invoke said provision(s) subsequently.
|
||||||
|
|
||||||
|
11.3 The Agreement cancels and replaces any or all previous agreements,
|
||||||
|
whether written or oral, between the Parties and having the same
|
||||||
|
purpose, and constitutes the entirety of the agreement between said
|
||||||
|
Parties concerning said purpose. No supplement or modification to the
|
||||||
|
terms and conditions hereof shall be effective as between the Parties
|
||||||
|
unless it is made in writing and signed by their duly authorized
|
||||||
|
representatives.
|
||||||
|
|
||||||
|
11.4 In the event that one or more of the provisions hereof were to
|
||||||
|
conflict with a current or future applicable act or legislative text,
|
||||||
|
said act or legislative text shall prevail, and the Parties shall make
|
||||||
|
the necessary amendments so as to comply with said act or legislative
|
||||||
|
text. All other provisions shall remain effective. Similarly, invalidity
|
||||||
|
of a provision of the Agreement, for any reason whatsoever, shall not
|
||||||
|
cause the Agreement as a whole to be invalid.
|
||||||
|
|
||||||
|
|
||||||
|
11.5 LANGUAGE
|
||||||
|
|
||||||
|
The Agreement is drafted in both French and English and both versions
|
||||||
|
are deemed authentic.
|
||||||
|
|
||||||
|
|
||||||
|
Article 12 - NEW VERSIONS OF THE AGREEMENT
|
||||||
|
|
||||||
|
12.1 Any person is authorized to duplicate and distribute copies of this
|
||||||
|
Agreement.
|
||||||
|
|
||||||
|
12.2 So as to ensure coherence, the wording of this Agreement is
|
||||||
|
protected and may only be modified by the authors of the License, who
|
||||||
|
reserve the right to periodically publish updates or new versions of the
|
||||||
|
Agreement, each with a separate number. These subsequent versions may
|
||||||
|
address new issues encountered by Free Software.
|
||||||
|
|
||||||
|
12.3 Any Software distributed under a given version of the Agreement may
|
||||||
|
only be subsequently distributed under the same version of the Agreement
|
||||||
|
or a subsequent version, subject to the provisions of Article 5.3.4
|
||||||
|
<#compatibility>.
|
||||||
|
|
||||||
|
|
||||||
|
Article 13 - GOVERNING LAW AND JURISDICTION
|
||||||
|
|
||||||
|
13.1 The Agreement is governed by French law. The Parties agree to
|
||||||
|
endeavor to seek an amicable solution to any disagreements or disputes
|
||||||
|
that may arise during the performance of the Agreement.
|
||||||
|
|
||||||
|
13.2 Failing an amicable solution within two (2) months as from their
|
||||||
|
occurrence, and unless emergency proceedings are necessary, the
|
||||||
|
disagreements or disputes shall be referred to the Paris Courts having
|
||||||
|
jurisdiction, by the more diligent Party.
|
||||||
70
gclc-process/pom.xml
Normal file
70
gclc-process/pom.xml
Normal file
@@ -0,0 +1,70 @@
|
|||||||
|
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
|
||||||
|
<modelVersion>4.0.0</modelVersion>
|
||||||
|
<parent>
|
||||||
|
<groupId>net.bigeon.config</groupId>
|
||||||
|
<artifactId>ebigeon-config</artifactId>
|
||||||
|
<version>1.8.21</version>
|
||||||
|
</parent>
|
||||||
|
|
||||||
|
<groupId>net.bigeon.gclc</groupId>
|
||||||
|
<artifactId>process</artifactId>
|
||||||
|
<version>0.0.5-SNAPSHOT</version>
|
||||||
|
<packaging>jar</packaging>
|
||||||
|
|
||||||
|
<name>process</name>
|
||||||
|
<description>A library to handle processes in a generic console application.</description><url>https://bigeon.net/projects/gclc.html</url>
|
||||||
|
<inceptionYear>2017</inceptionYear>
|
||||||
|
<organization>
|
||||||
|
<name>Bigeon</name>
|
||||||
|
<url>https://bigeon.net</url>
|
||||||
|
</organization>
|
||||||
|
<licenses>
|
||||||
|
<license>
|
||||||
|
<distribution>manual</distribution>
|
||||||
|
<name>CeCILL 2.1</name>
|
||||||
|
<url>https://cecill.info/licences/Licence_CeCILL_V2.1-en.html</url>
|
||||||
|
</license>
|
||||||
|
</licenses>
|
||||||
|
|
||||||
|
<developers>
|
||||||
|
<developer>
|
||||||
|
<email>emmanuel@bigeon.fr</email>
|
||||||
|
<name>Emmanuel Bigeon</name>
|
||||||
|
<url>bigeon.net</url>
|
||||||
|
<roles>
|
||||||
|
<role>PM</role>
|
||||||
|
</roles>
|
||||||
|
</developer>
|
||||||
|
</developers>
|
||||||
|
<scm>
|
||||||
|
<tag>HEAD</tag>
|
||||||
|
<developerConnection>scm:git:gogs@git.code.bigeon.net:emmanuel/gclc.git</developerConnection>
|
||||||
|
</scm>
|
||||||
|
<properties>
|
||||||
|
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
|
||||||
|
<copyright.email>emmanuel@bigeon.fr</copyright.email>
|
||||||
|
<license.licenseName>cecill_2.1</license.licenseName>
|
||||||
|
</properties>
|
||||||
|
<dependencies>
|
||||||
|
<dependency>
|
||||||
|
<groupId>net.bigeon</groupId>
|
||||||
|
<artifactId>gclc</artifactId>
|
||||||
|
<version>2.0.11</version>
|
||||||
|
</dependency>
|
||||||
|
</dependencies>
|
||||||
|
<reporting>
|
||||||
|
<plugins>
|
||||||
|
<plugin>
|
||||||
|
<groupId>org.apache.maven.plugins</groupId>
|
||||||
|
<artifactId>maven-javadoc-plugin</artifactId>
|
||||||
|
<version>2.10.3</version>
|
||||||
|
</plugin>
|
||||||
|
<plugin>
|
||||||
|
<groupId>com.github.sevntu-checkstyle</groupId>
|
||||||
|
<artifactId>dsm-maven-plugin</artifactId>
|
||||||
|
<version>2.2.0</version>
|
||||||
|
</plugin>
|
||||||
|
</plugins>
|
||||||
|
</reporting>
|
||||||
|
|
||||||
|
</project>
|
||||||
@@ -0,0 +1,187 @@
|
|||||||
|
/*
|
||||||
|
* process, Distribution repositories and basic setup for Emmanuel Bigeon projects
|
||||||
|
* Copyright (C) 2014-2018 E. Bigeon
|
||||||
|
* mailto:emmanuel@bigeon.fr
|
||||||
|
*
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
*/
|
||||||
|
/**
|
||||||
|
* gclc-process:net.bigeon.gclc.process.CommandFork.java
|
||||||
|
* Created on: Nov 13, 2017
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* process
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2014 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.logging.Level;
|
||||||
|
import java.util.logging.Logger;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.command.CommandParameters;
|
||||||
|
import net.bigeon.gclc.command.ParametrizedCommand;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunException;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunExceptionType;
|
||||||
|
import net.bigeon.gclc.exception.InvalidParameterException;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleInput;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleOutput;
|
||||||
|
|
||||||
|
/** A command that is launched inside an internal terminal.
|
||||||
|
* <p>
|
||||||
|
* Several things are to be considered before adding this command to an
|
||||||
|
* application:
|
||||||
|
* <ul>
|
||||||
|
* <li>The commands will be able to run in parallel.
|
||||||
|
* <li>The managing of the commands will be handled through piped systems and
|
||||||
|
* buffered in so switching to a forked command will actually print again all
|
||||||
|
* the command history to the output console.
|
||||||
|
* </ul>
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public class CommandForeground extends ParametrizedCommand {
|
||||||
|
|
||||||
|
/** Number of milliseconds in a second. */
|
||||||
|
private static final int MILLIS_IN_A_SEC = 1000;
|
||||||
|
/** The class logger. */
|
||||||
|
private static final Logger LOGGER = Logger
|
||||||
|
.getLogger(CommandForeground.class.getName());
|
||||||
|
|
||||||
|
/** The task pool to fetch task from. */
|
||||||
|
private final TaskPool pool;
|
||||||
|
|
||||||
|
/** Add the fork command.
|
||||||
|
*
|
||||||
|
* @param name the command name
|
||||||
|
* @param pool The pool to get joinable tasks from */
|
||||||
|
public CommandForeground(final String name, final TaskPool pool) {
|
||||||
|
super(name, false);
|
||||||
|
this.pool = pool;
|
||||||
|
addParameters();
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Add the parameters of the command. */
|
||||||
|
private void addParameters() {
|
||||||
|
try {
|
||||||
|
addStringParameter("pid", false);
|
||||||
|
addStringParameter("delai", false);
|
||||||
|
} catch (final InvalidParameterException e) {
|
||||||
|
// Cannot be reached unless GCLC base framework has an error
|
||||||
|
LOGGER.log(Level.SEVERE, "unexpected parameter error!", e);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.ParametrizedCommand#doExecute(fr.bigeon.gclc.
|
||||||
|
* manager.ConsoleOutput, fr.bigeon.gclc.manager.ConsoleInput,
|
||||||
|
* fr.bigeon.gclc.command.CommandParameters) */
|
||||||
|
@Override
|
||||||
|
protected void doExecute(final ConsoleOutput out, final ConsoleInput in,
|
||||||
|
final CommandParameters parameters) throws CommandRunException {
|
||||||
|
String string = parameters.get("pid");
|
||||||
|
if (string == null) {
|
||||||
|
final List<String> additionals = parameters.getAdditionals();
|
||||||
|
if (additionals.isEmpty()) {
|
||||||
|
throw new CommandRunException(CommandRunExceptionType.USAGE,
|
||||||
|
"Missing process id");
|
||||||
|
}
|
||||||
|
string = additionals.get(0);
|
||||||
|
}
|
||||||
|
Integer pid;
|
||||||
|
try {
|
||||||
|
pid = Integer.valueOf(string);
|
||||||
|
} catch (final NumberFormatException e) {
|
||||||
|
throw new CommandRunException(CommandRunExceptionType.USAGE,
|
||||||
|
"PID should be an integer");
|
||||||
|
}
|
||||||
|
// Join the command.
|
||||||
|
final Task cmd = pool.get(pid);
|
||||||
|
if (!(cmd instanceof ForkTask)) {
|
||||||
|
throw new CommandRunException("No such forked process");
|
||||||
|
}
|
||||||
|
long delai = 0;
|
||||||
|
final String delaiOpt = parameters.get("delai");
|
||||||
|
if (delaiOpt != null) {
|
||||||
|
delai = Long.parseLong(delaiOpt) * MILLIS_IN_A_SEC;
|
||||||
|
}
|
||||||
|
if (delai < 0) {
|
||||||
|
throw new CommandRunException(CommandRunExceptionType.USAGE,
|
||||||
|
"Join delai cannot be negative");
|
||||||
|
}
|
||||||
|
((ForkTask) cmd).join(out, in, delai);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.ICommand#tip() */
|
||||||
|
@Override
|
||||||
|
public String tip() {
|
||||||
|
return "Join the execution of a command, for a given amount of time";
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.Command#usageDetail() */
|
||||||
|
@Override
|
||||||
|
protected String usageDetail() {
|
||||||
|
return "";
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.Command#usagePattern() */
|
||||||
|
@Override
|
||||||
|
protected String usagePattern() {
|
||||||
|
return super.usagePattern() + " [(-pid) <id>] ([-delai <delai>])";
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,136 @@
|
|||||||
|
/**
|
||||||
|
* gclc-process:net.bigeon.gclc.process.CommandFork.java
|
||||||
|
* Created on: Nov 13, 2017
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process;
|
||||||
|
|
||||||
|
import java.text.MessageFormat;
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* process
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2014 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import java.util.Arrays;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.command.Command;
|
||||||
|
import net.bigeon.gclc.command.ICommand;
|
||||||
|
import net.bigeon.gclc.command.ICommandProvider;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunException;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunExceptionType;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleInput;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleOutput;
|
||||||
|
|
||||||
|
/** A command that is launched inside an internal terminal.
|
||||||
|
* <p>
|
||||||
|
* Several things are to be considered before adding this command to an
|
||||||
|
* application:
|
||||||
|
* <ul>
|
||||||
|
* <li>The commands will be able to run in parallel.
|
||||||
|
* <li>The managing of the commands will be handled through piped systems and
|
||||||
|
* buffered in so switching to a forked command will actually print again all
|
||||||
|
* the command history to the output console.
|
||||||
|
* </ul>
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public class CommandFork extends Command {
|
||||||
|
|
||||||
|
/** The task pool containing the tasks. */
|
||||||
|
private final TaskPool pool;
|
||||||
|
/** The command provider. */
|
||||||
|
private final ICommandProvider provider;
|
||||||
|
/** The number of lines stored in the commands. */
|
||||||
|
private final int lines;
|
||||||
|
|
||||||
|
/** Add the fork command.
|
||||||
|
*
|
||||||
|
* @param name the command name
|
||||||
|
* @param provider the allowed command collection */
|
||||||
|
public CommandFork(final String name, final ICommandProvider provider,
|
||||||
|
final TaskPool pool) {
|
||||||
|
this(name, provider, pool, -1);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Add the fork command.
|
||||||
|
*
|
||||||
|
* @param name the command name
|
||||||
|
* @param provider the allowed command collection */
|
||||||
|
public CommandFork(final String name, final ICommandProvider provider,
|
||||||
|
final TaskPool pool, final int lines) {
|
||||||
|
super(name);
|
||||||
|
this.provider = provider;
|
||||||
|
this.pool = pool;
|
||||||
|
this.lines = lines;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.command.ICommand#execute(net.bigeon.gclc.manager.
|
||||||
|
* ConsoleOutput, net.bigeon.gclc.manager.ConsoleInput, java.lang.String[]) */
|
||||||
|
@Override
|
||||||
|
public void execute(final ConsoleOutput out, final ConsoleInput in,
|
||||||
|
final String... args) throws CommandRunException {
|
||||||
|
if (args.length < 1) {
|
||||||
|
throw new CommandRunException(CommandRunExceptionType.USAGE,
|
||||||
|
"No command to fork");
|
||||||
|
}
|
||||||
|
final String string = args[0];
|
||||||
|
final ICommand cmd = provider.get(string);
|
||||||
|
if (cmd == null) {
|
||||||
|
throw new CommandRunException(CommandRunExceptionType.USAGE,
|
||||||
|
MessageFormat.format("No such command {0}", string));
|
||||||
|
}
|
||||||
|
final String[] inner = Arrays.copyOfRange(args, 1, args.length);
|
||||||
|
final ForkTask task = new ForkCommandTask(cmd, inner, lines);
|
||||||
|
final Thread th = new Thread(task, MessageFormat.format("fork [{0}]", string));
|
||||||
|
pool.add(task);
|
||||||
|
th.start();
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.ICommand#tip() */
|
||||||
|
@Override
|
||||||
|
public String tip() {
|
||||||
|
return "Command background launch";
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.Command#usageDetail() */
|
||||||
|
@Override
|
||||||
|
protected String usageDetail() {
|
||||||
|
return "";
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.Command#usagePattern() */
|
||||||
|
@Override
|
||||||
|
protected String usagePattern() {
|
||||||
|
return super.usagePattern() + " <command>";
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,103 @@
|
|||||||
|
/*
|
||||||
|
* process, Distribution repositories and basic setup for Emmanuel Bigeon projects
|
||||||
|
* Copyright (C) 2014-2018 E. Bigeon
|
||||||
|
* mailto:emmanuel@bigeon.fr
|
||||||
|
*
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
*/
|
||||||
|
/**
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* process
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2014 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import java.util.Arrays;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.command.ICommand;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunException;
|
||||||
|
|
||||||
|
/** @author Emmanuel Bigeon */
|
||||||
|
public class ForkCommandTask extends ForkTask {
|
||||||
|
private final ICommand command;
|
||||||
|
private final String[] args;
|
||||||
|
|
||||||
|
/** @param cmd the command
|
||||||
|
* @param args the arguements
|
||||||
|
* @param lines the number of print to store in the output */
|
||||||
|
public ForkCommandTask(final ICommand cmd, final String[] args, int lines) {
|
||||||
|
super(lines);
|
||||||
|
command = cmd;
|
||||||
|
this.args = Arrays.copyOf(args, args.length);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.process.ForkTask#doRun() */
|
||||||
|
@Override
|
||||||
|
protected void doRun() throws CommandRunException {
|
||||||
|
command.execute(out, in, args);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.process.Task#getName() */
|
||||||
|
@Override
|
||||||
|
public String getName() {
|
||||||
|
return command.getCommandName();
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
204
gclc-process/src/main/java/net/bigeon/gclc/process/ForkTask.java
Normal file
204
gclc-process/src/main/java/net/bigeon/gclc/process/ForkTask.java
Normal file
@@ -0,0 +1,204 @@
|
|||||||
|
/*
|
||||||
|
* process, Distribution repositories and basic setup for Emmanuel Bigeon projects
|
||||||
|
* Copyright (C) 2014-2018 E. Bigeon
|
||||||
|
* mailto:emmanuel@bigeon.fr
|
||||||
|
*
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
*/
|
||||||
|
/**
|
||||||
|
* gclc-process:net.bigeon.gclc.process.ForkTask.java
|
||||||
|
* Created on: Nov 13, 2017
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* process
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2014 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import java.util.HashSet;
|
||||||
|
import java.util.Set;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.exception.CommandRunException;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleInput;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleOutput;
|
||||||
|
import net.bigeon.gclc.process.io.ConnectingConsoleInput;
|
||||||
|
import net.bigeon.gclc.process.io.ConnectingConsoleOutput;
|
||||||
|
|
||||||
|
/** A task that is made to run into a thread.
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public abstract class ForkTask implements Task {
|
||||||
|
|
||||||
|
/** THe listeners. */
|
||||||
|
private final Set<InterruptionListener> listeners = new HashSet<>();
|
||||||
|
/** The running state. */
|
||||||
|
private boolean running = true;
|
||||||
|
/** The running state. */
|
||||||
|
private boolean started = false;
|
||||||
|
/** The connecting input for this task */
|
||||||
|
protected final ConnectingConsoleInput in = new ConnectingConsoleInput();
|
||||||
|
/** The connecting output for this task */
|
||||||
|
protected final ConnectingConsoleOutput out;
|
||||||
|
/** The exception of the run. */
|
||||||
|
private CommandRunException exception;
|
||||||
|
/** The synchronization lock. */
|
||||||
|
private final Object runLock = new Object();
|
||||||
|
|
||||||
|
/** Create the task.
|
||||||
|
*
|
||||||
|
* @param lines the number of print to store in the output */
|
||||||
|
public ForkTask(final int lines) {
|
||||||
|
out = new ConnectingConsoleOutput(ConnectingConsoleOutput.PERSIST, lines);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.process.Task#addInterruptionListener(fr.bigeon.gclc.
|
||||||
|
* process.InterruptionListener) */
|
||||||
|
@Override
|
||||||
|
public final void addInterruptionListener(final InterruptionListener listener) {
|
||||||
|
listeners.add(listener);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Actually run the fork. */
|
||||||
|
protected abstract void doRun() throws CommandRunException;
|
||||||
|
|
||||||
|
/** Get the excepion that caused a failure.
|
||||||
|
*
|
||||||
|
* @return the exception */
|
||||||
|
public final CommandRunException getException() {
|
||||||
|
return exception;
|
||||||
|
}
|
||||||
|
|
||||||
|
protected final Object getRunningLock() {
|
||||||
|
return runLock;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.process.Task#isRunning() */
|
||||||
|
@Override
|
||||||
|
public final boolean isRunning() {
|
||||||
|
synchronized (runLock) {
|
||||||
|
return running;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Join the task.
|
||||||
|
*
|
||||||
|
* @param out the console output
|
||||||
|
* @param in the console input
|
||||||
|
* @param timeout the maximal time to join for (0 for ever) */
|
||||||
|
public final void join(final ConsoleOutput out, final ConsoleInput in,
|
||||||
|
final long timeout) {
|
||||||
|
synchronized (runLock) {
|
||||||
|
this.out.connect(out);
|
||||||
|
this.in.connect(in);
|
||||||
|
try {
|
||||||
|
if (running) {
|
||||||
|
runLock.wait(timeout);
|
||||||
|
}
|
||||||
|
} catch (final InterruptedException e) {
|
||||||
|
Thread.currentThread().interrupt();
|
||||||
|
}
|
||||||
|
this.out.disconnect();
|
||||||
|
this.in.disconnect();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see
|
||||||
|
* net.bigeon.gclc.process.Task#rmInterruptionListener(net.bigeon.gclc.process
|
||||||
|
* .InterruptionListener) */
|
||||||
|
@Override
|
||||||
|
public final void rmInterruptionListener(final InterruptionListener listener) {
|
||||||
|
listeners.remove(listener);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see java.lang.Runnable#run() */
|
||||||
|
@Override
|
||||||
|
public final void run() {
|
||||||
|
synchronized (runLock) {
|
||||||
|
started = true;
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
doRun();
|
||||||
|
} catch (final CommandRunException e) {
|
||||||
|
exception = e;
|
||||||
|
} finally {
|
||||||
|
setRunning(false);
|
||||||
|
}
|
||||||
|
for (final InterruptionListener interruptionListener : listeners) {
|
||||||
|
interruptionListener.interrupted();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.process.Task#setRunning(boolean) */
|
||||||
|
@Override
|
||||||
|
public final void setRunning(final boolean running) {
|
||||||
|
synchronized (runLock) {
|
||||||
|
this.running = running;
|
||||||
|
runLock.notifyAll();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** @return the started */
|
||||||
|
public boolean isStarted() {
|
||||||
|
synchronized (runLock) {
|
||||||
|
return started;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,78 @@
|
|||||||
|
/*
|
||||||
|
* process, Distribution repositories and basic setup for Emmanuel Bigeon projects
|
||||||
|
* Copyright (C) 2014-2018 E. Bigeon
|
||||||
|
* mailto:emmanuel@bigeon.fr
|
||||||
|
*
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
*/
|
||||||
|
/**
|
||||||
|
* gclc:fr.bigeon.gclc.proc.InterruptionListener.java
|
||||||
|
* Created on: May 10, 2017
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* process
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2014 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
/** A listener for interruption.
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
@FunctionalInterface
|
||||||
|
public interface InterruptionListener {
|
||||||
|
/** Notification of an interuption of a listened object */
|
||||||
|
void interrupted();
|
||||||
|
}
|
||||||
@@ -0,0 +1,94 @@
|
|||||||
|
/*
|
||||||
|
* process, Distribution repositories and basic setup for Emmanuel Bigeon projects
|
||||||
|
* Copyright (C) 2014-2018 E. Bigeon
|
||||||
|
* mailto:emmanuel@bigeon.fr
|
||||||
|
*
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
*/
|
||||||
|
/**
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* process
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2014 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import net.bigeon.gclc.ApplicationAttachement;
|
||||||
|
import net.bigeon.gclc.command.ICommandProvider;
|
||||||
|
import net.bigeon.gclc.exception.InvalidCommandName;
|
||||||
|
|
||||||
|
/** @author Emmanuel Bigeon */
|
||||||
|
public class ProcessAttachement implements ApplicationAttachement {
|
||||||
|
|
||||||
|
private final TaskPool pool;
|
||||||
|
|
||||||
|
/** @param pool the task pool to manage */
|
||||||
|
public ProcessAttachement(TaskPool pool) {
|
||||||
|
super();
|
||||||
|
this.pool = pool;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.ApplicationAttachement#attach(fr.bigeon.gclc.
|
||||||
|
* ConsoleApplication) */
|
||||||
|
@Override
|
||||||
|
public void attach(ICommandProvider application) throws InvalidCommandName {
|
||||||
|
application.add(new ProcessKill("kill", pool));
|
||||||
|
application.add(new ProcessList("list", pool));
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
@@ -0,0 +1,117 @@
|
|||||||
|
/*
|
||||||
|
* process, Distribution repositories and basic setup for Emmanuel Bigeon projects
|
||||||
|
* Copyright (C) 2014-2018 E. Bigeon
|
||||||
|
* mailto:emmanuel@bigeon.fr
|
||||||
|
*
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
*/
|
||||||
|
/**
|
||||||
|
* gclc:fr.bigeon.gclc.proc.ProcessList.java
|
||||||
|
* Created on: May 10, 2017
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* process
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2014 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import net.bigeon.gclc.command.Command;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleInput;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleOutput;
|
||||||
|
|
||||||
|
/** A command that will flag a task to stop
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public final class ProcessClear extends Command {
|
||||||
|
/** The taskpool */
|
||||||
|
private final TaskPool pool;
|
||||||
|
|
||||||
|
/** @param name the command name
|
||||||
|
* @param pool the pool */
|
||||||
|
public ProcessClear(final String name, final TaskPool pool) {
|
||||||
|
super(name);
|
||||||
|
this.pool = pool;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.ICommand#execute(fr.bigeon.gclc.manager.
|
||||||
|
* ConsoleOutput, fr.bigeon.gclc.manager.ConsoleInput, java.lang.String[]) */
|
||||||
|
@Override
|
||||||
|
public void execute(final ConsoleOutput out, final ConsoleInput in,
|
||||||
|
final String... args) {
|
||||||
|
for (final Integer id : pool.getPIDs()) {
|
||||||
|
if (!pool.get(id).isRunning()) {
|
||||||
|
pool.remove(id);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.ICommand#tip() */
|
||||||
|
@Override
|
||||||
|
public String tip() {
|
||||||
|
return "Remove non running processes from pool";
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.Command#usageDetail() */
|
||||||
|
@Override
|
||||||
|
protected String usageDetail() {
|
||||||
|
return " All processes in the pool have their running status checked and the "
|
||||||
|
+ "non running ones are removed from the list of tasks.";
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
@@ -0,0 +1,124 @@
|
|||||||
|
/*
|
||||||
|
* process, Distribution repositories and basic setup for Emmanuel Bigeon projects
|
||||||
|
* Copyright (C) 2014-2018 E. Bigeon
|
||||||
|
* mailto:emmanuel@bigeon.fr
|
||||||
|
*
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
*/
|
||||||
|
/**
|
||||||
|
* gclc:fr.bigeon.gclc.proc.ProcessList.java
|
||||||
|
* Created on: May 10, 2017
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* process
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2014 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import net.bigeon.gclc.command.Command;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunException;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunExceptionType;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleInput;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleOutput;
|
||||||
|
|
||||||
|
/** A command that will flag a task to stop
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public final class ProcessKill extends Command {
|
||||||
|
/** The taskpool */
|
||||||
|
private final TaskPool pool;
|
||||||
|
|
||||||
|
/** @param name the command name
|
||||||
|
* @param pool the pool */
|
||||||
|
public ProcessKill(final String name, final TaskPool pool) {
|
||||||
|
super(name);
|
||||||
|
this.pool = pool;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.ICommand#execute(fr.bigeon.gclc.manager.
|
||||||
|
* ConsoleOutput, fr.bigeon.gclc.manager.ConsoleInput, java.lang.String[]) */
|
||||||
|
@Override
|
||||||
|
public void execute(final ConsoleOutput out, final ConsoleInput in,
|
||||||
|
final String... args) throws CommandRunException {
|
||||||
|
if (args.length < 1) {
|
||||||
|
throw new CommandRunException(CommandRunExceptionType.USAGE,
|
||||||
|
"A pid should be specified.");
|
||||||
|
}
|
||||||
|
pool.get(Integer.parseInt(args[0])).setRunning(false);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.ICommand#tip() */
|
||||||
|
@Override
|
||||||
|
public String tip() {
|
||||||
|
return "Request a process to stop (softly)";
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.Command#usageDetail() */
|
||||||
|
@Override
|
||||||
|
protected String usageDetail() {
|
||||||
|
return " <pid> is the identification of the process to request the stop to in the pool";
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.command.Command#usagePattern() */
|
||||||
|
@Override
|
||||||
|
protected String usagePattern() {
|
||||||
|
return super.usagePattern() + " <pid>";
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,130 @@
|
|||||||
|
/*
|
||||||
|
* process, Distribution repositories and basic setup for Emmanuel Bigeon projects
|
||||||
|
* Copyright (C) 2014-2018 E. Bigeon
|
||||||
|
* mailto:emmanuel@bigeon.fr
|
||||||
|
*
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
*/
|
||||||
|
/**
|
||||||
|
* gclc:fr.bigeon.gclc.proc.ProcessList.java
|
||||||
|
* Created on: May 10, 2017
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* process
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2014 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.text.MessageFormat;
|
||||||
|
import java.util.ArrayList;
|
||||||
|
import java.util.Collections;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.command.Command;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunException;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunExceptionType;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleInput;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleOutput;
|
||||||
|
|
||||||
|
/** A command to list current processes
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public final class ProcessList extends Command {
|
||||||
|
/** The process pool */
|
||||||
|
private final TaskPool pool;
|
||||||
|
|
||||||
|
/** @param name the command name
|
||||||
|
* @param pool the pool */
|
||||||
|
public ProcessList(final String name, final TaskPool pool) {
|
||||||
|
super(name);
|
||||||
|
this.pool = pool;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.ICommand#execute(fr.bigeon.gclc.manager.
|
||||||
|
* ConsoleOutput, fr.bigeon.gclc.manager.ConsoleInput, java.lang.String[]) */
|
||||||
|
@Override
|
||||||
|
public void execute(final ConsoleOutput out, final ConsoleInput in,
|
||||||
|
final String... args) throws CommandRunException {
|
||||||
|
final ArrayList<Integer> pids = new ArrayList<>(pool.getPIDs());
|
||||||
|
Collections.sort(pids);
|
||||||
|
for (final Integer string : pids) {
|
||||||
|
try {
|
||||||
|
out.println(MessageFormat.format("{0}\t{1}", string, //$NON-NLS-1$
|
||||||
|
pool.get(string).getName()));
|
||||||
|
} catch (final IOException e) {
|
||||||
|
throw new CommandRunException(CommandRunExceptionType.INTERACTION,
|
||||||
|
"Unable to communicate with user", e); //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.ICommand#tip() */
|
||||||
|
@Override
|
||||||
|
public String tip() {
|
||||||
|
return "List all processes";
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.Command#usageDetail() */
|
||||||
|
@Override
|
||||||
|
protected String usageDetail() {
|
||||||
|
return " No argument is considered by this command";
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
@@ -0,0 +1,98 @@
|
|||||||
|
/*
|
||||||
|
* process, Distribution repositories and basic setup for Emmanuel Bigeon projects
|
||||||
|
* Copyright (C) 2014-2018 E. Bigeon
|
||||||
|
* mailto:emmanuel@bigeon.fr
|
||||||
|
*
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
*/
|
||||||
|
/**
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* process
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2014 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import net.bigeon.gclc.ApplicationAttachement;
|
||||||
|
import net.bigeon.gclc.command.ICommandProvider;
|
||||||
|
import net.bigeon.gclc.exception.InvalidCommandName;
|
||||||
|
|
||||||
|
/** @author Emmanuel Bigeon */
|
||||||
|
public class ScreenAttachement implements ApplicationAttachement {
|
||||||
|
|
||||||
|
private final TaskPool pool;
|
||||||
|
private final int lines;
|
||||||
|
|
||||||
|
/** @param pool the task pool to manage */
|
||||||
|
public ScreenAttachement(TaskPool pool, int lines) {
|
||||||
|
super();
|
||||||
|
this.pool = pool;
|
||||||
|
this.lines = lines;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.ApplicationAttachement#attach(fr.bigeon.gclc.
|
||||||
|
* ConsoleApplication) */
|
||||||
|
@Override
|
||||||
|
public void attach(ICommandProvider application) throws InvalidCommandName {
|
||||||
|
application.add(new ProcessKill("terminate", pool));
|
||||||
|
application.add(new ProcessList("list", pool));
|
||||||
|
application.add(new ProcessClear("clear", pool));
|
||||||
|
application.add(new CommandForeground("fg", pool));
|
||||||
|
application.add(new CommandFork("fork", application, pool, lines));
|
||||||
|
}
|
||||||
|
}
|
||||||
111
gclc-process/src/main/java/net/bigeon/gclc/process/Task.java
Normal file
111
gclc-process/src/main/java/net/bigeon/gclc/process/Task.java
Normal file
@@ -0,0 +1,111 @@
|
|||||||
|
/*
|
||||||
|
* process, Distribution repositories and basic setup for Emmanuel Bigeon projects
|
||||||
|
* Copyright (C) 2014-2018 E. Bigeon
|
||||||
|
* mailto:emmanuel@bigeon.fr
|
||||||
|
*
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
*/
|
||||||
|
/**
|
||||||
|
* gclc:fr.bigeon.gclc.proc.ThreadCommand.java
|
||||||
|
* Created on: May 10, 2017
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* process
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2014 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
/** Tasks are named runnable that can be interrupted.
|
||||||
|
* <p>
|
||||||
|
* Good practice for those objects include an absence of interaction with the
|
||||||
|
* user (otherwise the user may not know from which running command comes
|
||||||
|
* information and requests) and unicity of the object to have a coherent
|
||||||
|
* control through the {@link #setRunning(boolean)} method.
|
||||||
|
* <p>
|
||||||
|
* Typical cases where such command can be useful is for an application that
|
||||||
|
* does long computations.
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public interface Task extends Runnable {
|
||||||
|
/** Add a listener for this command end of execution
|
||||||
|
*
|
||||||
|
* @param listener the listener */
|
||||||
|
void addInterruptionListener(InterruptionListener listener);
|
||||||
|
|
||||||
|
/** Get the task name.
|
||||||
|
*
|
||||||
|
* @return the task name */
|
||||||
|
String getName();
|
||||||
|
|
||||||
|
/** Test the running status of the task.
|
||||||
|
*
|
||||||
|
* @return if the command is supposed to be running */
|
||||||
|
boolean isRunning();
|
||||||
|
|
||||||
|
/** Remove a listener of this command end of execution
|
||||||
|
*
|
||||||
|
* @param listener the listener */
|
||||||
|
void rmInterruptionListener(InterruptionListener listener);
|
||||||
|
|
||||||
|
/** Set the running state.
|
||||||
|
* <p>
|
||||||
|
* This method should be only called by external objects with the false
|
||||||
|
* argument. Calling this method with true has unspecified behavior and could do
|
||||||
|
* nothing as well as restart the command for example.
|
||||||
|
*
|
||||||
|
* @param running the running state */
|
||||||
|
void setRunning(boolean running);
|
||||||
|
}
|
||||||
179
gclc-process/src/main/java/net/bigeon/gclc/process/TaskPool.java
Normal file
179
gclc-process/src/main/java/net/bigeon/gclc/process/TaskPool.java
Normal file
@@ -0,0 +1,179 @@
|
|||||||
|
/*
|
||||||
|
* process, Distribution repositories and basic setup for Emmanuel Bigeon projects
|
||||||
|
* Copyright (C) 2014-2018 E. Bigeon
|
||||||
|
* mailto:emmanuel@bigeon.fr
|
||||||
|
*
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
*/
|
||||||
|
/**
|
||||||
|
* gclc:fr.bigeon.gclc.proc.TaskPool.java
|
||||||
|
* Created on: May 10, 2017
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* process
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2014 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import java.util.Collection;
|
||||||
|
import java.util.HashMap;
|
||||||
|
import java.util.HashSet;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
/** A process pool.
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public final class TaskPool {
|
||||||
|
/** The running processes. */
|
||||||
|
private final Map<Integer, Task> running = new HashMap<>();
|
||||||
|
/** The count for process id. */
|
||||||
|
private int count = 0;
|
||||||
|
/** The lock for pid attribution synchronization. */
|
||||||
|
private final Object lock = new Object();
|
||||||
|
private final boolean autoClear;
|
||||||
|
|
||||||
|
/** Default constructor. */
|
||||||
|
public TaskPool() {
|
||||||
|
this(true);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Default constructor. */
|
||||||
|
public TaskPool(final boolean autoClear) {
|
||||||
|
this.autoClear = autoClear;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Add a process in the pool.
|
||||||
|
*
|
||||||
|
* @param cmd the process
|
||||||
|
* @return the pid */
|
||||||
|
public int add(final Task cmd) {
|
||||||
|
if (cmd == null) {
|
||||||
|
throw new IllegalArgumentException("Task cannot be null"); //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
final int pid;
|
||||||
|
synchronized (lock) {
|
||||||
|
pid = getPID();
|
||||||
|
running.put(pid, cmd);
|
||||||
|
}
|
||||||
|
if (autoClear) {
|
||||||
|
cmd.addInterruptionListener(new InterruptionListener() {
|
||||||
|
@Override
|
||||||
|
public void interrupted() {
|
||||||
|
remove(pid);
|
||||||
|
cmd.rmInterruptionListener(this);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
return pid;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Get a process by it associated identifier.
|
||||||
|
*
|
||||||
|
* @param pid the task id
|
||||||
|
* @return the task, if any, associated to this id */
|
||||||
|
public Task get(final int pid) {
|
||||||
|
synchronized (lock) {
|
||||||
|
return running.get(Integer.valueOf(pid));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Get the next process id.
|
||||||
|
*
|
||||||
|
* @return the process id */
|
||||||
|
private int getPID() {
|
||||||
|
synchronized (lock) {
|
||||||
|
int pid;
|
||||||
|
do {
|
||||||
|
pid = count++;
|
||||||
|
} while (running.containsKey(Integer.valueOf(pid)));
|
||||||
|
return pid;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Get the running processes' identifiers.
|
||||||
|
*
|
||||||
|
* @return the pids */
|
||||||
|
public Collection<Integer> getPIDs() {
|
||||||
|
return new HashSet<>(running.keySet());
|
||||||
|
}
|
||||||
|
|
||||||
|
/** @return if the clearing of ended task is automatic */
|
||||||
|
public boolean isAutoClearing() {
|
||||||
|
return autoClear;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Remove a task from the pool
|
||||||
|
*
|
||||||
|
* @param pid the task id */
|
||||||
|
public void remove(final int pid) {
|
||||||
|
synchronized (lock) {
|
||||||
|
running.remove(Integer.valueOf(pid));
|
||||||
|
count = Math.min(count, (pid));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Request all task to stop running.
|
||||||
|
* <p>
|
||||||
|
* This call does not guaranty end of execution, it is up to the task
|
||||||
|
* implementation to actually take into account the termination request. */
|
||||||
|
public void shutdown() {
|
||||||
|
synchronized (lock) {
|
||||||
|
for (final Task task : running.values()) {
|
||||||
|
task.setRunning(false);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,113 @@
|
|||||||
|
/*
|
||||||
|
* process, Distribution repositories and basic setup for Emmanuel Bigeon projects
|
||||||
|
* Copyright (C) 2014-2018 E. Bigeon
|
||||||
|
* mailto:emmanuel@bigeon.fr
|
||||||
|
*
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
*/
|
||||||
|
/**
|
||||||
|
* gclc:fr.bigeon.gclc.proc.ProcessList.java
|
||||||
|
* Created on: May 10, 2017
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* process
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2014 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import java.util.concurrent.ExecutorService;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.command.Command;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunException;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleInput;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleOutput;
|
||||||
|
|
||||||
|
/** An abstract command to generate a task and return the control to the user
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public abstract class TaskSpawner extends Command {
|
||||||
|
/** The process pool */
|
||||||
|
private final TaskPool pool;
|
||||||
|
private final ExecutorService threadPool;
|
||||||
|
|
||||||
|
/** @param name the command name
|
||||||
|
* @param pool the pool */
|
||||||
|
public TaskSpawner(final String name, final TaskPool pool,
|
||||||
|
final ExecutorService threadPool) {
|
||||||
|
super(name);
|
||||||
|
this.pool = pool;
|
||||||
|
this.threadPool = threadPool;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** @param in the input
|
||||||
|
* @param out the output
|
||||||
|
* @param args the arguments
|
||||||
|
* @return the process to start and add to the pool
|
||||||
|
* @throws CommandRunException if the task creation failed */
|
||||||
|
protected abstract Task createTask(ConsoleOutput out, ConsoleInput in, String... args)
|
||||||
|
throws CommandRunException;
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.ICommand#execute(fr.bigeon.gclc.manager.
|
||||||
|
* ConsoleOutput, fr.bigeon.gclc.manager.ConsoleInput, java.lang.String[]) */
|
||||||
|
@Override
|
||||||
|
public final void execute(final ConsoleOutput out, final ConsoleInput in,
|
||||||
|
final String... args) throws CommandRunException {
|
||||||
|
final Task task = createTask(out, in, args);
|
||||||
|
pool.add(task);
|
||||||
|
threadPool.execute(task);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,280 @@
|
|||||||
|
/*
|
||||||
|
* process, Distribution repositories and basic setup for Emmanuel Bigeon projects
|
||||||
|
* Copyright (C) 2014-2018 E. Bigeon
|
||||||
|
* mailto:emmanuel@bigeon.fr
|
||||||
|
*
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
*/
|
||||||
|
/**
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process.io;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* process
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2014 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.util.logging.Level;
|
||||||
|
import java.util.logging.Logger;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.manager.ConsoleInput;
|
||||||
|
import net.bigeon.gclc.tools.ConstantString;
|
||||||
|
import net.bigeon.gclc.tools.StringProvider;
|
||||||
|
|
||||||
|
/** A console input that can be connected to and diconnected from.
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public final class ConnectingConsoleInput implements ConsoleInput {
|
||||||
|
|
||||||
|
/** The empty string provider. */
|
||||||
|
private static final ConstantString EMPTY_STRING = new ConstantString("");
|
||||||
|
/** The logger. */
|
||||||
|
private static final Logger LOGGER = Logger
|
||||||
|
.getLogger(ConnectingConsoleInput.class.getName());
|
||||||
|
|
||||||
|
/** If the input is closed. */
|
||||||
|
private boolean close = false;
|
||||||
|
/** The prompt string. */
|
||||||
|
private StringProvider prompt = EMPTY_STRING;
|
||||||
|
/** If the input is currently in prompting state.
|
||||||
|
* <p>
|
||||||
|
* To change it you should be in a promptLock. */
|
||||||
|
private boolean prompting = false;
|
||||||
|
/** The synchronization lock for the prompting status. */
|
||||||
|
private final Object promptLock = new Object();
|
||||||
|
/** The synchronization lock for the connection status. */
|
||||||
|
private final Object connectionLock = new Object();
|
||||||
|
/** The connected console input.
|
||||||
|
* <p>
|
||||||
|
* To use it, you should be in a promptLock and connectionLock. */
|
||||||
|
private ConsoleInput connected = null;
|
||||||
|
/** The connection state.
|
||||||
|
* <p>
|
||||||
|
* To read or modify it, you should be in a connectionLock synchronize block. */
|
||||||
|
private boolean disconnection = false;
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleInput#close() */
|
||||||
|
@Override
|
||||||
|
public void close() {
|
||||||
|
close = true;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Connect an input.
|
||||||
|
*
|
||||||
|
* @param input the input to connect */
|
||||||
|
public void connect(final ConsoleInput input) {
|
||||||
|
disconnect();
|
||||||
|
synchronized (promptLock) {
|
||||||
|
connected = input;
|
||||||
|
promptLock.notifyAll();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Disconnect the current input. */
|
||||||
|
public void disconnect() {
|
||||||
|
synchronized (promptLock) {
|
||||||
|
synchronized (connectionLock) {
|
||||||
|
if (connected != null) {
|
||||||
|
disconnection = true;
|
||||||
|
connected.interruptPrompt();
|
||||||
|
connected = null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleInput#getPrompt() */
|
||||||
|
@Override
|
||||||
|
public StringProvider getPrompt() {
|
||||||
|
return prompt;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleInput#interruptPrompt() */
|
||||||
|
@Override
|
||||||
|
public void interruptPrompt() {
|
||||||
|
synchronized (promptLock) {
|
||||||
|
prompting = false;
|
||||||
|
if (connected != null) {
|
||||||
|
connected.interruptPrompt();
|
||||||
|
}
|
||||||
|
promptLock.notifyAll();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleInput#isClosed() */
|
||||||
|
@Override
|
||||||
|
public boolean isClosed() {
|
||||||
|
return close;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleInput#prompt() */
|
||||||
|
@Override
|
||||||
|
public String prompt() throws IOException {
|
||||||
|
return prompt(prompt.apply());
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleInput#prompt(long) */
|
||||||
|
@Override
|
||||||
|
public String prompt(final long timeout) throws IOException {
|
||||||
|
return prompt(prompt.apply(), timeout);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleInput#prompt(java.lang.String) */
|
||||||
|
@Override
|
||||||
|
public String prompt(final String message) throws IOException {
|
||||||
|
synchronized (promptLock) {
|
||||||
|
prompting = true;
|
||||||
|
}
|
||||||
|
while (true) {
|
||||||
|
synchronized (promptLock) {
|
||||||
|
if (!prompting) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
boolean connect;
|
||||||
|
synchronized (connectionLock) {
|
||||||
|
connect = connected != null;
|
||||||
|
}
|
||||||
|
if (!connect) {
|
||||||
|
try {
|
||||||
|
promptLock.wait();
|
||||||
|
} catch (final InterruptedException e) {
|
||||||
|
LOGGER.log(Level.WARNING, "Inerruption of console thread", e);
|
||||||
|
Thread.currentThread().interrupt();
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
synchronized (connectionLock) {
|
||||||
|
final String res = connected.prompt(message);
|
||||||
|
if (disconnection) {
|
||||||
|
disconnection = false;
|
||||||
|
} else if (prompting) {
|
||||||
|
return res;
|
||||||
|
} else {
|
||||||
|
// prompt interrupted, lose the result.
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleInput#prompt(java.lang.String, long) */
|
||||||
|
@Override
|
||||||
|
public String prompt(final String message, final long timeout) throws IOException {
|
||||||
|
if (timeout <= 0) {
|
||||||
|
return prompt(message);
|
||||||
|
}
|
||||||
|
final long end = System.currentTimeMillis() + timeout;
|
||||||
|
synchronized (promptLock) {
|
||||||
|
prompting = true;
|
||||||
|
}
|
||||||
|
do {
|
||||||
|
synchronized (promptLock) {
|
||||||
|
if (!prompting) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
boolean connect;
|
||||||
|
synchronized (connectionLock) {
|
||||||
|
connect = connected != null;
|
||||||
|
}
|
||||||
|
if (!connect) {
|
||||||
|
try {
|
||||||
|
promptLock.wait(timeout);
|
||||||
|
} catch (final InterruptedException e) {
|
||||||
|
LOGGER.log(Level.WARNING, "Inerruption of console thread", e);
|
||||||
|
Thread.currentThread().interrupt();
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
synchronized (connectionLock) {
|
||||||
|
final String res = connected.prompt(message,
|
||||||
|
end - System.currentTimeMillis());
|
||||||
|
if (disconnection) {
|
||||||
|
disconnection = false;
|
||||||
|
} else if (prompting) {
|
||||||
|
return res;
|
||||||
|
} else {
|
||||||
|
// prompt interrupted, lose the result.
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} while (System.currentTimeMillis() < end);
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleInput#setPrompt(java.lang.String) */
|
||||||
|
@Override
|
||||||
|
public void setPrompt(final String prompt) {
|
||||||
|
this.prompt = new ConstantString(prompt);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleInput#setPrompt(fr.bigeon.gclc.tools.
|
||||||
|
* StringProvider) */
|
||||||
|
@Override
|
||||||
|
public void setPrompt(final StringProvider string) {
|
||||||
|
prompt = string;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,197 @@
|
|||||||
|
/*
|
||||||
|
* process, Distribution repositories and basic setup for Emmanuel Bigeon projects
|
||||||
|
* Copyright (C) 2014-2018 E. Bigeon
|
||||||
|
* mailto:emmanuel@bigeon.fr
|
||||||
|
*
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
*/
|
||||||
|
/**
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process.io;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* process
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2014 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.util.ArrayDeque;
|
||||||
|
import java.util.Deque;
|
||||||
|
import java.util.logging.Level;
|
||||||
|
import java.util.logging.Logger;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.manager.ConsoleOutput;
|
||||||
|
|
||||||
|
/** A console output that can be connected and disconnected from.
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public class ConnectingConsoleOutput implements ConsoleOutput {
|
||||||
|
|
||||||
|
/** The logger. */
|
||||||
|
private static final Logger LOGGER = Logger
|
||||||
|
.getLogger(ConnectingConsoleOutput.class.getName());
|
||||||
|
/** The flag indicating that the un-delivered message should be stored. */
|
||||||
|
public static final int QUEUE = 1;
|
||||||
|
/** The flag indicating that the messages should be stored in all cases. */
|
||||||
|
public static final int PERSIST = 1 << 1;
|
||||||
|
/** The connected output console */
|
||||||
|
private ConsoleOutput output;
|
||||||
|
/** If the console is closed */
|
||||||
|
private boolean close = false;
|
||||||
|
|
||||||
|
/** If the messages should be stored. */
|
||||||
|
private final boolean persistent;
|
||||||
|
/** If the message should be stored until delivery. */
|
||||||
|
private final boolean queued;
|
||||||
|
/** The messages. */
|
||||||
|
private final Deque<String> messages;
|
||||||
|
/** The number of stored messages. */
|
||||||
|
private final int lines;
|
||||||
|
|
||||||
|
/** Create the console output.
|
||||||
|
*
|
||||||
|
* @param style the type of redirected output
|
||||||
|
* @param lines the number of lines to store */
|
||||||
|
public ConnectingConsoleOutput(final int style, final int lines) {
|
||||||
|
super();
|
||||||
|
this.lines = lines;
|
||||||
|
queued = (style & QUEUE) != 0;
|
||||||
|
persistent = (style & PERSIST) != 0;
|
||||||
|
if (lines > 0) {
|
||||||
|
messages = new ArrayDeque<>(lines);
|
||||||
|
} else {
|
||||||
|
messages = new ArrayDeque<>();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Add a message.
|
||||||
|
*
|
||||||
|
* @param text the message */
|
||||||
|
private synchronized void addMessage(final String text) {
|
||||||
|
if (persistent || queued && output == null) {
|
||||||
|
if (messages.size() == lines) {
|
||||||
|
messages.poll();
|
||||||
|
}
|
||||||
|
messages.offer(text);
|
||||||
|
}
|
||||||
|
if (output != null) {
|
||||||
|
try {
|
||||||
|
output.print(text);
|
||||||
|
} catch (final IOException e) {
|
||||||
|
LOGGER.severe("nable to print to connecting console");
|
||||||
|
LOGGER.log(Level.FINE, "Console error", e);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see java.lang.AutoCloseable#close() */
|
||||||
|
@Override
|
||||||
|
public void close() {
|
||||||
|
close = true;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Connect an output.
|
||||||
|
*
|
||||||
|
* @param output the output */
|
||||||
|
public synchronized void connect(final ConsoleOutput output) {
|
||||||
|
this.output = output;
|
||||||
|
for (final String string : messages) {
|
||||||
|
try {
|
||||||
|
output.print(string);
|
||||||
|
} catch (final IOException e) {
|
||||||
|
LOGGER.severe("nable to print to connecting console");
|
||||||
|
LOGGER.log(Level.FINE, "Console error", e);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (!persistent) {
|
||||||
|
messages.clear();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Disconnect the currently connected output. */
|
||||||
|
public synchronized void disconnect() {
|
||||||
|
output = null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleOutput#isClosed() */
|
||||||
|
@Override
|
||||||
|
public boolean isClosed() {
|
||||||
|
return close;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleOutput#print(java.lang.String) */
|
||||||
|
@Override
|
||||||
|
public void print(final String text) {
|
||||||
|
addMessage(text);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleOutput#println() */
|
||||||
|
@Override
|
||||||
|
public void println() {
|
||||||
|
addMessage(System.lineSeparator());
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleOutput#println(java.lang.String) */
|
||||||
|
@Override
|
||||||
|
public void println(final String message) {
|
||||||
|
addMessage(message + System.lineSeparator());
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,42 @@
|
|||||||
|
/** Connecting Input and Output related classes.
|
||||||
|
* <p>
|
||||||
|
* This package groups the Connecting classes that are used to be able to put
|
||||||
|
* the tasks in background and foreground and reattach the actual console input
|
||||||
|
* and outputs to the tasks' ones.
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
package net.bigeon.gclc.process.io;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* process
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2014 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
@@ -0,0 +1,48 @@
|
|||||||
|
/** This package defines elements for processes inside a console application.
|
||||||
|
* <p>
|
||||||
|
* Processes are tasks that are run in background of the application. One may
|
||||||
|
* want to temporarily connect to such a task (through
|
||||||
|
* {@link net.bigeon.gclc.process.CommandForeground}), or verify it's actual
|
||||||
|
* running status (through {@link net.bigeon.gclc.process.ProcessList}. One may
|
||||||
|
* also want to start such a process (through
|
||||||
|
* {@link net.bigeon.gclc.process.ForkCommandTask}) or close it (through
|
||||||
|
* {@link net.bigeon.gclc.process.ProcessKill}).
|
||||||
|
* <p>
|
||||||
|
* The task list can be managed by several commands to list or clear it.
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
package net.bigeon.gclc.process;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* process
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2014 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
44
gclc-process/src/site/site.xml
Normal file
44
gclc-process/src/site/site.xml
Normal file
@@ -0,0 +1,44 @@
|
|||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<!--
|
||||||
|
#%L
|
||||||
|
Generic Command Ligne console
|
||||||
|
%%
|
||||||
|
Copyright (C) 2014 - 2018 Bigeon
|
||||||
|
%%
|
||||||
|
This software is governed by the CeCILL license under French law and
|
||||||
|
abiding by the rules of distribution of free software. You can use,
|
||||||
|
modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
"http://www.cecill.info".
|
||||||
|
|
||||||
|
As a counterpart to the access to the source code and rights to copy,
|
||||||
|
modify and redistribute granted by the license, users are provided only
|
||||||
|
with a limited warranty and the software's author, the holder of the
|
||||||
|
economic rights, and the successive licensors have only limited
|
||||||
|
liability.
|
||||||
|
|
||||||
|
In this respect, the user's attention is drawn to the risks associated
|
||||||
|
with loading, using, modifying and/or developing or reproducing the
|
||||||
|
software by the user in light of its specific status of free software,
|
||||||
|
that may mean that it is complicated to manipulate, and that also
|
||||||
|
therefore means that it is reserved for developers and experienced
|
||||||
|
professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
encouraged to load and test the software's suitability as regards their
|
||||||
|
requirements in conditions enabling the security of their systems and/or
|
||||||
|
data to be ensured and, more generally, to use and operate it in the
|
||||||
|
same conditions as regards security.
|
||||||
|
|
||||||
|
The fact that you are presently reading this means that you have had
|
||||||
|
knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
#L%
|
||||||
|
-->
|
||||||
|
|
||||||
|
<project name="GCLC">
|
||||||
|
<bannerRight>
|
||||||
|
<src>https://bigeon.net/images/logo_48.png</src>
|
||||||
|
<href>https://bigeon.net/</href>
|
||||||
|
</bannerRight>
|
||||||
|
<body>
|
||||||
|
<menu ref="reports"/>
|
||||||
|
</body>
|
||||||
|
</project>
|
||||||
@@ -0,0 +1,90 @@
|
|||||||
|
/**
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process;
|
||||||
|
|
||||||
|
import static org.junit.Assert.assertEquals;
|
||||||
|
import static org.junit.Assert.assertNotNull;
|
||||||
|
import static org.junit.Assert.fail;
|
||||||
|
|
||||||
|
import org.junit.Test;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.exception.CommandRunException;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunExceptionType;
|
||||||
|
import net.bigeon.gclc.process.mocks.ForkTaskMock;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Emmanuel Bigeon
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
public class CommandForegroundTest {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Test method for {@link net.bigeon.gclc.process.CommandForeground#CommandForeground(java.lang.String, net.bigeon.gclc.process.TaskPool)}.
|
||||||
|
*/
|
||||||
|
@Test
|
||||||
|
public void testCommandForeground() {
|
||||||
|
final CommandForeground pl = new CommandForeground("fg", new TaskPool());
|
||||||
|
assertEquals("Command name should be kept as specified", "fg",
|
||||||
|
pl.getCommandName());
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Test method for
|
||||||
|
* {@link net.bigeon.gclc.process.CommandForeground#doExecute(net.bigeon.gclc.manager.ConsoleOutput, net.bigeon.gclc.manager.ConsoleInput, net.bigeon.gclc.command.CommandParameters)}.
|
||||||
|
*
|
||||||
|
* @throws CommandRunException if a valid command failed */
|
||||||
|
@Test
|
||||||
|
public void testDoExecuteConsoleOutputConsoleInputCommandParameters()
|
||||||
|
throws CommandRunException {
|
||||||
|
final TaskPool pool = new TaskPool(false);
|
||||||
|
final CommandForeground pl = new CommandForeground("fg", pool);
|
||||||
|
|
||||||
|
try {
|
||||||
|
pl.execute(null, null, "-delai", "1");
|
||||||
|
fail("PID should be mandatory");
|
||||||
|
} catch (final CommandRunException e) {
|
||||||
|
assertEquals("No pid specified is a usage error",
|
||||||
|
CommandRunExceptionType.USAGE, e.getType());
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
pl.execute(null, null, "-pid", "invalid", "-delai", "1");
|
||||||
|
fail("PID should be a number");
|
||||||
|
} catch (final CommandRunException e) {
|
||||||
|
assertEquals("Invalid pid specified is a usage error",
|
||||||
|
CommandRunExceptionType.USAGE, e.getType());
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
pl.execute(null, null, "-pid", "2", "-delai", "1");
|
||||||
|
fail("PID should exist");
|
||||||
|
} catch (final CommandRunException e) {
|
||||||
|
assertEquals("Inexistent pid specified is a run error",
|
||||||
|
CommandRunExceptionType.EXECUTION, e.getType());
|
||||||
|
}
|
||||||
|
|
||||||
|
final ForkTaskMock cmd = new ForkTaskMock();
|
||||||
|
final int id = pool.add(cmd);
|
||||||
|
pl.execute(null, null, "-pid", Integer.toString(id), "-delai", "1");
|
||||||
|
|
||||||
|
try {
|
||||||
|
pl.execute(null, null, "-pid", Integer.toString(id), "-delai", "-1");
|
||||||
|
fail("delai should be a posistive number");
|
||||||
|
} catch (final CommandRunException e) {
|
||||||
|
assertEquals("Negative delai specified is a usage error",
|
||||||
|
CommandRunExceptionType.USAGE, e.getType());
|
||||||
|
}
|
||||||
|
|
||||||
|
assert cmd.getRunCall() == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Test method for {@link net.bigeon.gclc.process.CommandForeground#tip()}.
|
||||||
|
*/
|
||||||
|
@Test
|
||||||
|
public void testTip() {
|
||||||
|
final CommandForeground pl = new CommandForeground("fg", new TaskPool());
|
||||||
|
assertNotNull("Command tip should be defined", pl.tip());
|
||||||
|
assertNotNull("Command usage should be defined", pl.usagePattern());
|
||||||
|
assertNotNull("Command usage should be defined", pl.usageDetail());
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
@@ -0,0 +1,86 @@
|
|||||||
|
/**
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process;
|
||||||
|
|
||||||
|
import static org.junit.Assert.assertEquals;
|
||||||
|
import static org.junit.Assert.assertNotNull;
|
||||||
|
import static org.junit.Assert.fail;
|
||||||
|
|
||||||
|
import org.junit.Test;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.command.ICommandProvider;
|
||||||
|
import net.bigeon.gclc.command.SubedCommand;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunException;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunExceptionType;
|
||||||
|
import net.bigeon.gclc.exception.InvalidCommandName;
|
||||||
|
import net.bigeon.gclc.process.mocks.CommandMock;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Emmanuel Bigeon
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
public class CommandForkTest {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Test method for {@link net.bigeon.gclc.process.CommandFork#CommandFork(java.lang.String, net.bigeon.gclc.command.ICommandProvider, net.bigeon.gclc.process.TaskPool)}.
|
||||||
|
*/
|
||||||
|
@Test
|
||||||
|
public void testCommandForkStringICommandProviderTaskPool() {
|
||||||
|
final TaskPool pool = new TaskPool();
|
||||||
|
final ICommandProvider provider = new SubedCommand("test");
|
||||||
|
final CommandFork pl = new CommandFork("fork", provider, pool);
|
||||||
|
assertEquals("Command name should be preserved", "fork", pl.getCommandName());
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Test method for
|
||||||
|
* {@link net.bigeon.gclc.process.CommandFork#execute(net.bigeon.gclc.manager.ConsoleOutput, net.bigeon.gclc.manager.ConsoleInput, java.lang.String[])}.
|
||||||
|
*
|
||||||
|
* @throws InvalidCommandName if the test init failed
|
||||||
|
* @throws CommandRunException */
|
||||||
|
@Test
|
||||||
|
public void testExecute() throws InvalidCommandName, CommandRunException {
|
||||||
|
final TaskPool pool = new TaskPool(false);
|
||||||
|
final ICommandProvider provider = new SubedCommand("test");
|
||||||
|
final CommandFork pl = new CommandFork("fork", provider, pool);
|
||||||
|
|
||||||
|
try {
|
||||||
|
pl.execute(null, null);
|
||||||
|
fail("No command specified should through an exception");
|
||||||
|
} catch (final CommandRunException e) {
|
||||||
|
assertEquals("No command specified is a usage error",
|
||||||
|
CommandRunExceptionType.USAGE, e.getType());
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
pl.execute(null, null, "invalid");
|
||||||
|
fail("Invalid command specified should through an exception");
|
||||||
|
} catch (final CommandRunException e) {
|
||||||
|
assertEquals("Invalid command specified is a usage error",
|
||||||
|
CommandRunExceptionType.USAGE, e.getType());
|
||||||
|
}
|
||||||
|
|
||||||
|
final CommandMock mock = new CommandMock();
|
||||||
|
provider.add(mock);
|
||||||
|
|
||||||
|
pl.execute(null, null, mock.getCommandName());
|
||||||
|
|
||||||
|
final ForkTask task = (ForkTask) pool.get(pool.getPIDs().iterator().next());
|
||||||
|
task.join(null, null, 1000);
|
||||||
|
|
||||||
|
assertEquals("Command should be executed when forked", 1, mock.getExecuteCall());
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Test method for {@link net.bigeon.gclc.process.CommandFork#tip()}.
|
||||||
|
*/
|
||||||
|
@Test
|
||||||
|
public void testTip() {
|
||||||
|
final TaskPool pool = new TaskPool();
|
||||||
|
final ICommandProvider provider = new SubedCommand("test");
|
||||||
|
final CommandFork pl = new CommandFork("fork", provider, pool);
|
||||||
|
assertNotNull("Command tip should be defined", pl.tip());
|
||||||
|
assertNotNull("Command usage should be defined", pl.usagePattern());
|
||||||
|
assertNotNull("Command usage should be defined", pl.usageDetail());
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
@@ -0,0 +1,35 @@
|
|||||||
|
/**
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process;
|
||||||
|
|
||||||
|
import static org.junit.Assert.assertEquals;
|
||||||
|
|
||||||
|
import org.junit.Test;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.process.mocks.CommandMock;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Emmanuel Bigeon
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
public class ForkCommandTaskTest {
|
||||||
|
|
||||||
|
/** Test method for
|
||||||
|
* {@link net.bigeon.gclc.process.ForkCommandTask#ForkCommandTask(net.bigeon.gclc.command.ICommand, java.lang.String[], int)}.
|
||||||
|
*
|
||||||
|
* @throws InterruptedException if there is an error in the thread join */
|
||||||
|
@Test
|
||||||
|
public void testForkCommandTask() throws InterruptedException {
|
||||||
|
final CommandMock cmd = new CommandMock();
|
||||||
|
final ForkCommandTask task = new ForkCommandTask(cmd, new String[0], 1);
|
||||||
|
|
||||||
|
final Thread th = new Thread(task);
|
||||||
|
th.start();
|
||||||
|
th.join();
|
||||||
|
|
||||||
|
assertEquals("Task should be executed once", 1, cmd.getExecuteCall());
|
||||||
|
assertEquals("Names should be consistent between task and command",
|
||||||
|
cmd.getCommandName(), task.getName());
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,62 @@
|
|||||||
|
/**
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process;
|
||||||
|
|
||||||
|
import static org.junit.Assert.assertEquals;
|
||||||
|
import static org.junit.Assert.assertFalse;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
|
||||||
|
import org.junit.Test;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.exception.CommandRunException;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunExceptionType;
|
||||||
|
import net.bigeon.gclc.utils.PipedConsoleInput;
|
||||||
|
import net.bigeon.gclc.utils.PipedConsoleOutput;
|
||||||
|
|
||||||
|
/** @author Emmanuel Bigeon */
|
||||||
|
public class ForkTaskTest {
|
||||||
|
|
||||||
|
@Test
|
||||||
|
public void testGenericForkTask() throws IOException {
|
||||||
|
final ForkTask task = new ForkTask(5) {
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public String getName() {
|
||||||
|
return "name";
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
protected void doRun() throws CommandRunException {
|
||||||
|
String msg;
|
||||||
|
try {
|
||||||
|
msg = in.prompt();
|
||||||
|
} catch (final IOException e) {
|
||||||
|
throw new CommandRunException(CommandRunExceptionType.INTERACTION,
|
||||||
|
"Unable to prompt user");
|
||||||
|
}
|
||||||
|
if ("ok".equals(msg)) {
|
||||||
|
out.println("Message");
|
||||||
|
} else {
|
||||||
|
out.println("fail");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
final Thread execThread = new Thread(task);
|
||||||
|
execThread.start();
|
||||||
|
|
||||||
|
try (PipedConsoleOutput pco = new PipedConsoleOutput();
|
||||||
|
PipedConsoleInput pci = new PipedConsoleInput(null)) {
|
||||||
|
pci.type("ok");
|
||||||
|
while (!pco.available()) {
|
||||||
|
task.join(pco, pci, 1000);
|
||||||
|
}
|
||||||
|
assertEquals("Execution should work", "Message", pco.readNextLine());
|
||||||
|
}
|
||||||
|
assertFalse("Running state should be updated by task on its completion",
|
||||||
|
task.isRunning());
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
@@ -0,0 +1,53 @@
|
|||||||
|
/**
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process;
|
||||||
|
|
||||||
|
import static org.junit.Assert.assertEquals;
|
||||||
|
import static org.junit.Assert.assertNotNull;
|
||||||
|
import static org.junit.Assert.assertTrue;
|
||||||
|
|
||||||
|
import org.junit.Test;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.process.mocks.TaskMock;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Emmanuel Bigeon
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
public class ProcessClearTest {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Test method for {@link net.bigeon.gclc.process.ProcessClear#ProcessClear(java.lang.String, net.bigeon.gclc.process.TaskPool)}.
|
||||||
|
*/
|
||||||
|
@Test
|
||||||
|
public void testProcessClear() {
|
||||||
|
final ProcessClear pl = new ProcessClear("clear", new TaskPool());
|
||||||
|
assertEquals("Command name should be kept as specified", "clear",
|
||||||
|
pl.getCommandName());
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Test method for {@link net.bigeon.gclc.process.ProcessClear#execute(net.bigeon.gclc.manager.ConsoleOutput, net.bigeon.gclc.manager.ConsoleInput, java.lang.String[])}.
|
||||||
|
*/
|
||||||
|
@Test
|
||||||
|
public void testExecute() {
|
||||||
|
final TaskPool pool = new TaskPool();
|
||||||
|
final TaskMock task = new TaskMock();
|
||||||
|
pool.add(task);
|
||||||
|
final ProcessClear pl = new ProcessClear("clear", pool);
|
||||||
|
pl.execute(null, null);
|
||||||
|
assertTrue("cleared pool should be empty", pool.getPIDs().isEmpty());
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Test method for {@link net.bigeon.gclc.process.ProcessClear#tip()}.
|
||||||
|
*/
|
||||||
|
@Test
|
||||||
|
public void testTip() {
|
||||||
|
final ProcessClear pl = new ProcessClear("clear", new TaskPool());
|
||||||
|
assertNotNull("Command tip should be defined", pl.tip());
|
||||||
|
assertNotNull("Command usage should be defined", pl.usageDetail());
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
@@ -0,0 +1,65 @@
|
|||||||
|
/**
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process;
|
||||||
|
|
||||||
|
import static org.junit.Assert.assertEquals;
|
||||||
|
import static org.junit.Assert.assertNotNull;
|
||||||
|
import static org.junit.Assert.fail;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
|
||||||
|
import org.junit.Test;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.exception.CommandRunException;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunExceptionType;
|
||||||
|
import net.bigeon.gclc.process.mocks.TaskMock;
|
||||||
|
|
||||||
|
/** @author Emmanuel Bigeon */
|
||||||
|
public class ProcessKillTest {
|
||||||
|
|
||||||
|
/** Test method for
|
||||||
|
* {@link net.bigeon.gclc.process.ProcessKill#ProcessKill(java.lang.String, net.bigeon.gclc.process.TaskPool)}. */
|
||||||
|
@Test
|
||||||
|
public void testProcessKill() {
|
||||||
|
final ProcessList pl = new ProcessList("kill", new TaskPool());
|
||||||
|
assertEquals("Command name should be kept as specified", "kill",
|
||||||
|
pl.getCommandName());
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Test method for
|
||||||
|
* {@link net.bigeon.gclc.process.ProcessKill#execute(net.bigeon.gclc.manager.ConsoleOutput, net.bigeon.gclc.manager.ConsoleInput, java.lang.String[])}.
|
||||||
|
*
|
||||||
|
* @throws CommandRunException if an error occured in test
|
||||||
|
* @throws IOException if an error occured with the console output */
|
||||||
|
@Test
|
||||||
|
public void testExecute() throws CommandRunException {
|
||||||
|
final TaskPool pool = new TaskPool();
|
||||||
|
final TaskMock task = new TaskMock();
|
||||||
|
final int id = pool.add(task);
|
||||||
|
final ProcessKill pl = new ProcessKill("kill", pool);
|
||||||
|
task.reset();
|
||||||
|
try {
|
||||||
|
pl.execute(null, null);
|
||||||
|
fail("Execution with no pid should raise exception");
|
||||||
|
} catch (final CommandRunException e) {
|
||||||
|
assertEquals("Usage exception expected", CommandRunExceptionType.USAGE,
|
||||||
|
e.getType());
|
||||||
|
}
|
||||||
|
pl.execute(null, null, Integer.toString(id));
|
||||||
|
assertEquals("Task should be shutdown", 1, task.getNumberSetRunning());
|
||||||
|
task.reset();
|
||||||
|
pl.execute(null, null, Integer.toString(id));
|
||||||
|
assertEquals("Task should be shutdown", 1, task.getNumberSetRunning());
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Test method for {@link net.bigeon.gclc.process.ProcessKill#tip()}. */
|
||||||
|
@Test
|
||||||
|
public void testTip() {
|
||||||
|
final ProcessKill pl = new ProcessKill("kill", new TaskPool());
|
||||||
|
assertNotNull("Command tip should be defined", pl.tip());
|
||||||
|
assertNotNull("Command usage should be defined", pl.usagePattern());
|
||||||
|
assertNotNull("Command usage should be defined", pl.usageDetail());
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
@@ -0,0 +1,67 @@
|
|||||||
|
/**
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process;
|
||||||
|
|
||||||
|
import static org.junit.Assert.assertEquals;
|
||||||
|
import static org.junit.Assert.assertNotNull;
|
||||||
|
import static org.junit.Assert.assertTrue;
|
||||||
|
import static org.junit.Assert.fail;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
|
||||||
|
import org.junit.Test;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.exception.CommandRunException;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunExceptionType;
|
||||||
|
import net.bigeon.gclc.process.mocks.TaskMock;
|
||||||
|
import net.bigeon.gclc.utils.PipedConsoleOutput;
|
||||||
|
|
||||||
|
/** @author Emmanuel Bigeon */
|
||||||
|
public class ProcessListTest {
|
||||||
|
|
||||||
|
/** Test method for
|
||||||
|
* {@link net.bigeon.gclc.process.ProcessList#ProcessList(java.lang.String, net.bigeon.gclc.process.TaskPool)}. */
|
||||||
|
@Test
|
||||||
|
public void testProcessList() {
|
||||||
|
final ProcessList pl = new ProcessList("list", new TaskPool());
|
||||||
|
assertEquals("Command name should be kept as specified", "list",
|
||||||
|
pl.getCommandName());
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Test method for
|
||||||
|
* {@link net.bigeon.gclc.process.ProcessList#execute(net.bigeon.gclc.manager.ConsoleOutput, net.bigeon.gclc.manager.ConsoleInput, java.lang.String[])}.
|
||||||
|
*
|
||||||
|
* @throws CommandRunException if an error occured
|
||||||
|
* @throws IOException if an error in initialization of console occured */
|
||||||
|
@Test
|
||||||
|
public void testExecute() throws CommandRunException, IOException {
|
||||||
|
final TaskPool pool = new TaskPool();
|
||||||
|
final TaskMock task = new TaskMock();
|
||||||
|
pool.add(task);
|
||||||
|
final ProcessList pl = new ProcessList("list", pool);
|
||||||
|
final PipedConsoleOutput out = new PipedConsoleOutput();
|
||||||
|
pl.execute(out, null);
|
||||||
|
|
||||||
|
assertTrue("Task should be contained in list",
|
||||||
|
out.readNextLine().contains(task.getName()));
|
||||||
|
|
||||||
|
out.close();
|
||||||
|
|
||||||
|
try {
|
||||||
|
pl.execute(out, null);
|
||||||
|
fail("Printing element to closed console should raise interaction exception");
|
||||||
|
} catch (final CommandRunException e) {
|
||||||
|
assertEquals("Console printing error should be an interaction error",
|
||||||
|
CommandRunExceptionType.INTERACTION, e.getType());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Test method for {@link net.bigeon.gclc.process.ProcessList#tip()}. */
|
||||||
|
@Test
|
||||||
|
public void testTip() {
|
||||||
|
final ProcessList pl = new ProcessList("list", new TaskPool());
|
||||||
|
assertNotNull("Command tip should be defined", pl.tip());
|
||||||
|
assertNotNull("Command usage should be defined", pl.usageDetail());
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,77 @@
|
|||||||
|
package net.bigeon.gclc.process;
|
||||||
|
|
||||||
|
import static org.junit.Assert.assertEquals;
|
||||||
|
import static org.junit.Assert.assertFalse;
|
||||||
|
import static org.junit.Assert.assertNull;
|
||||||
|
import static org.junit.Assert.assertTrue;
|
||||||
|
|
||||||
|
import org.junit.Test;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.process.mocks.TaskMock;
|
||||||
|
|
||||||
|
public class TaskPoolTest {
|
||||||
|
|
||||||
|
public TaskMock task = new TaskMock();
|
||||||
|
public TaskPool pool = new TaskPool(false);
|
||||||
|
|
||||||
|
@Test
|
||||||
|
public void testTaskPool() {
|
||||||
|
assertFalse("task pool should not auto clear if specified",
|
||||||
|
pool.isAutoClearing());
|
||||||
|
pool = new TaskPool();
|
||||||
|
assertTrue("Default task pool should not auto clear", pool.isAutoClearing());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
public void testAdd() {
|
||||||
|
final int id = pool.add(task);
|
||||||
|
assertTrue("Added task pid should be in pool", pool.getPIDs().contains(id));
|
||||||
|
assertEquals("Added task should be in pool", task, pool.get(id));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
public void testGet() {
|
||||||
|
assertNull("Inexistent task id should provide null as task in pool",
|
||||||
|
pool.get(60));
|
||||||
|
final int id = pool.add(task);
|
||||||
|
assertEquals("Added task should be in pool at its id", task, pool.get(id));
|
||||||
|
assertNull("Added task should be in pool at its id", pool.get(id + 1));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
public void testGetPIDs() {
|
||||||
|
assertTrue("new pool should be empty", pool.getPIDs().isEmpty());
|
||||||
|
final int id = pool.add(task);
|
||||||
|
assertNull("Added task should be in pool at its id", pool.get(id + 1));
|
||||||
|
assertEquals(
|
||||||
|
"Pool task addition should change the pid collection size accordingly", 1,
|
||||||
|
pool.getPIDs().size());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
public void testRemove() {
|
||||||
|
assertTrue("new pool should be empty", pool.getPIDs().isEmpty());
|
||||||
|
pool.remove(60);
|
||||||
|
assertTrue("removal of inexistent task should be NOP", pool.getPIDs().isEmpty());
|
||||||
|
final int id = pool.add(task);
|
||||||
|
assertEquals(
|
||||||
|
"Pool task addition should change the pid collection size accordingly", 1,
|
||||||
|
pool.getPIDs().size());
|
||||||
|
pool.remove(id + 1);
|
||||||
|
assertEquals("removal of inexistent task should be NOP", 1,
|
||||||
|
pool.getPIDs().size());
|
||||||
|
pool.remove(id);
|
||||||
|
assertTrue("removal of task should reduce the number of tasks",
|
||||||
|
pool.getPIDs().isEmpty());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
public void testShutdown() {
|
||||||
|
final int id = pool.add(task);
|
||||||
|
task.reset();
|
||||||
|
pool.shutdown();
|
||||||
|
assertEquals("Shutdown should request shut down of tasks, only once", 1,
|
||||||
|
task.getNumberSetRunning());
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
@@ -0,0 +1,65 @@
|
|||||||
|
package net.bigeon.gclc.process.io;
|
||||||
|
|
||||||
|
import static org.junit.Assert.assertEquals;
|
||||||
|
import static org.junit.Assert.assertFalse;
|
||||||
|
import static org.junit.Assert.assertNull;
|
||||||
|
import static org.junit.Assert.assertTrue;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
|
||||||
|
import org.junit.Test;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.tools.ConstantString;
|
||||||
|
import net.bigeon.gclc.utils.PipedConsoleInput;
|
||||||
|
|
||||||
|
public class ConnectingConsoleInputTest {
|
||||||
|
|
||||||
|
@Test
|
||||||
|
public void testConnect() throws IOException {
|
||||||
|
final ConnectingConsoleInput in = new ConnectingConsoleInput();
|
||||||
|
final PipedConsoleInput pci = new PipedConsoleInput(null);
|
||||||
|
assertNull("Inputs should not transmit before connection", in.prompt(1000));
|
||||||
|
in.connect(pci);
|
||||||
|
pci.type("Some message");
|
||||||
|
assertEquals("Messages should be buffered", "Some message", in.prompt());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
public void testDisconnect() throws IOException {
|
||||||
|
final ConnectingConsoleInput in = new ConnectingConsoleInput();
|
||||||
|
final PipedConsoleInput pci = new PipedConsoleInput(null);
|
||||||
|
assertNull("Inputs should not transmit before connection", in.prompt(1000));
|
||||||
|
in.connect(pci);
|
||||||
|
pci.type("Some message");
|
||||||
|
assertEquals("Messages should be buffered", "Some message", in.prompt());
|
||||||
|
in.disconnect();
|
||||||
|
assertNull("Disconnected inputs should not transmit anymore", in.prompt(1000));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
public void testIsClosed() throws IOException {
|
||||||
|
final ConnectingConsoleInput in = new ConnectingConsoleInput();
|
||||||
|
assertFalse("New input should not be closed", in.isClosed());
|
||||||
|
final PipedConsoleInput pci = new PipedConsoleInput(null);
|
||||||
|
in.connect(pci);
|
||||||
|
pci.close();
|
||||||
|
assertFalse("Connected input closing should not close connecting", in.isClosed());
|
||||||
|
final PipedConsoleInput pci2 = new PipedConsoleInput(null);
|
||||||
|
in.connect(pci2);
|
||||||
|
in.close();
|
||||||
|
assertTrue("Input should close on request", in.isClosed());
|
||||||
|
assertFalse("Connected input should not be closed by connecting closure",
|
||||||
|
pci2.isClosed());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
public void testCoveragePrompt() {
|
||||||
|
final ConnectingConsoleInput in = new ConnectingConsoleInput();
|
||||||
|
in.setPrompt("test");
|
||||||
|
assertEquals("Prompt should be set correctly", "test",
|
||||||
|
((ConstantString) in.getPrompt()).apply());
|
||||||
|
final ConstantString prompt = new ConstantString("other");
|
||||||
|
in.setPrompt(prompt);
|
||||||
|
assertEquals("Prompt should be set correctly", prompt, in.getPrompt());
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,88 @@
|
|||||||
|
package net.bigeon.gclc.process.io;
|
||||||
|
|
||||||
|
import static org.junit.Assert.assertEquals;
|
||||||
|
import static org.junit.Assert.assertFalse;
|
||||||
|
import static org.junit.Assert.assertTrue;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
|
||||||
|
import org.junit.Test;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.utils.PipedConsoleOutput;
|
||||||
|
|
||||||
|
public class ConnectingConsoleOutputTest {
|
||||||
|
|
||||||
|
@Test
|
||||||
|
public void testConnect() throws IOException {
|
||||||
|
final ConnectingConsoleOutput out = new ConnectingConsoleOutput(
|
||||||
|
ConnectingConsoleOutput.QUEUE, 10);
|
||||||
|
final PipedConsoleOutput output = new PipedConsoleOutput();
|
||||||
|
out.println("Some message");
|
||||||
|
assertFalse("Message should not be transmitted", output.available());
|
||||||
|
// Connect
|
||||||
|
out.connect(output);
|
||||||
|
|
||||||
|
// Connected outputs should receive data
|
||||||
|
final String res = output.readNextLine();
|
||||||
|
assertEquals("Message should be correctly transmitted", "Some message", res);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
public void testDisconnect() throws IOException {
|
||||||
|
final ConnectingConsoleOutput out = new ConnectingConsoleOutput(
|
||||||
|
ConnectingConsoleOutput.QUEUE, 10);
|
||||||
|
final PipedConsoleOutput output = new PipedConsoleOutput();
|
||||||
|
// NOP disconnection when no connection
|
||||||
|
out.disconnect();
|
||||||
|
// Connect
|
||||||
|
out.connect(output);
|
||||||
|
|
||||||
|
// Connected outputs should receive data
|
||||||
|
out.println("Some message");
|
||||||
|
final String res = output.readNextLine();
|
||||||
|
assertEquals("Message should be correctly transmitted", "Some message", res);
|
||||||
|
out.disconnect();
|
||||||
|
out.println("Some message");
|
||||||
|
assertFalse("Message should not be transmitted", output.available());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
public void testIsClosed() throws IOException {
|
||||||
|
final ConnectingConsoleOutput out = new ConnectingConsoleOutput(
|
||||||
|
ConnectingConsoleOutput.QUEUE, 10);
|
||||||
|
final PipedConsoleOutput output = new PipedConsoleOutput();
|
||||||
|
assertFalse("New output should not be closed", out.isClosed());
|
||||||
|
// Connect
|
||||||
|
out.connect(output);
|
||||||
|
|
||||||
|
output.close();
|
||||||
|
|
||||||
|
assertFalse("Output should not close when connected outputs do", out.isClosed());
|
||||||
|
final PipedConsoleOutput output2 = new PipedConsoleOutput();
|
||||||
|
out.connect(output2);
|
||||||
|
out.close();
|
||||||
|
assertTrue("Output should close on request", out.isClosed());
|
||||||
|
assertFalse("Output should not close connected output when they do",
|
||||||
|
output2.isClosed());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
public void testPrint() throws IOException {
|
||||||
|
final ConnectingConsoleOutput out = new ConnectingConsoleOutput(
|
||||||
|
ConnectingConsoleOutput.PERSIST, 10);
|
||||||
|
|
||||||
|
out.print("Some text");
|
||||||
|
out.println();
|
||||||
|
final PipedConsoleOutput output = new PipedConsoleOutput();
|
||||||
|
out.connect(output);
|
||||||
|
String res = output.readNextLine();
|
||||||
|
assertEquals("Message should be correctly transmitted", "Some text", res);
|
||||||
|
out.disconnect();
|
||||||
|
|
||||||
|
// Persist should be reprinted on any connect
|
||||||
|
out.connect(output);
|
||||||
|
res = output.readNextLine();
|
||||||
|
assertEquals("Message should be correctly transmitted", "Some text", res);
|
||||||
|
out.disconnect();
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,60 @@
|
|||||||
|
/**
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process.mocks;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.command.ICommand;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunException;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleInput;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleOutput;
|
||||||
|
|
||||||
|
/** @author Emmanuel Bigeon */
|
||||||
|
public class CommandMock implements ICommand {
|
||||||
|
|
||||||
|
private int executeCall = 0;
|
||||||
|
private int tipCall = 0;
|
||||||
|
private int helpCall = 0;
|
||||||
|
private int commandNameCall = 0;
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.command.ICommand#execute(net.bigeon.gclc.manager.
|
||||||
|
* ConsoleOutput, net.bigeon.gclc.manager.ConsoleInput, java.lang.String[]) */
|
||||||
|
@Override
|
||||||
|
public void execute(final ConsoleOutput out, final ConsoleInput in,
|
||||||
|
final String... args) throws CommandRunException {
|
||||||
|
executeCall++;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.command.ICommand#getCommandName() */
|
||||||
|
@Override
|
||||||
|
public String getCommandName() {
|
||||||
|
commandNameCall++;
|
||||||
|
return "name";
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see
|
||||||
|
* net.bigeon.gclc.command.ICommand#help(net.bigeon.gclc.manager.ConsoleOutput,
|
||||||
|
* java.lang.String[]) */
|
||||||
|
@Override
|
||||||
|
public void help(final ConsoleOutput output, final String... args)
|
||||||
|
throws IOException {
|
||||||
|
helpCall++;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.command.ICommand#tip() */
|
||||||
|
@Override
|
||||||
|
public String tip() {
|
||||||
|
tipCall++;
|
||||||
|
return "tip";
|
||||||
|
}
|
||||||
|
|
||||||
|
/** @return the executeCall */
|
||||||
|
public int getExecuteCall() {
|
||||||
|
return executeCall;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,43 @@
|
|||||||
|
/**
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.process.mocks;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.exception.CommandRunException;
|
||||||
|
import net.bigeon.gclc.process.ForkTask;
|
||||||
|
import net.bigeon.gclc.process.Task;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @author Emmanuel Bigeon
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
public class ForkTaskMock extends ForkTask implements Task {
|
||||||
|
|
||||||
|
private int runCall = 0;
|
||||||
|
|
||||||
|
/** @param lines */
|
||||||
|
public ForkTaskMock() {
|
||||||
|
super(10);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.process.Task#getName()
|
||||||
|
*/
|
||||||
|
@Override
|
||||||
|
public String getName() {
|
||||||
|
return "name";
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.process.ForkTask#doRun()
|
||||||
|
*/
|
||||||
|
@Override
|
||||||
|
protected void doRun() throws CommandRunException {
|
||||||
|
runCall++;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** @return the runCall */
|
||||||
|
public int getRunCall() {
|
||||||
|
return runCall;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,57 @@
|
|||||||
|
package net.bigeon.gclc.process.mocks;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.process.InterruptionListener;
|
||||||
|
import net.bigeon.gclc.process.Task;
|
||||||
|
|
||||||
|
public class TaskMock implements Task {
|
||||||
|
|
||||||
|
private int runCall = 0;
|
||||||
|
private int setRunningCall = 0;
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
runCall++;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void addInterruptionListener(final InterruptionListener listener) {
|
||||||
|
// TODO Auto-generated method stub
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public String getName() {
|
||||||
|
return "name";
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public boolean isRunning() {
|
||||||
|
// TODO Auto-generated method stub
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void rmInterruptionListener(final InterruptionListener listener) {
|
||||||
|
// TODO Auto-generated method stub
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void setRunning(final boolean running) {
|
||||||
|
setRunningCall++;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
public void reset() {
|
||||||
|
runCall = 0;
|
||||||
|
setRunningCall = 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** @return */
|
||||||
|
public Object getNumberSetRunning() {
|
||||||
|
return setRunningCall;
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
@@ -0,0 +1,4 @@
|
|||||||
|
/** Mock definitions for testing.
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
package net.bigeon.gclc.process.mocks;
|
||||||
517
gclc-socket/LICENSE.txt
Normal file
517
gclc-socket/LICENSE.txt
Normal file
@@ -0,0 +1,517 @@
|
|||||||
|
CeCILL FREE SOFTWARE LICENSE AGREEMENT
|
||||||
|
|
||||||
|
Version 2.1 dated 2013-06-21
|
||||||
|
|
||||||
|
|
||||||
|
Notice
|
||||||
|
|
||||||
|
This Agreement is a Free Software license agreement that is the result
|
||||||
|
of discussions between its authors in order to ensure compliance with
|
||||||
|
the two main principles guiding its drafting:
|
||||||
|
|
||||||
|
* firstly, compliance with the principles governing the distribution
|
||||||
|
of Free Software: access to source code, broad rights granted to users,
|
||||||
|
* secondly, the election of a governing law, French law, with which it
|
||||||
|
is conformant, both as regards the law of torts and intellectual
|
||||||
|
property law, and the protection that it offers to both authors and
|
||||||
|
holders of the economic rights over software.
|
||||||
|
|
||||||
|
The authors of the CeCILL (for Ce[a] C[nrs] I[nria] L[ogiciel] L[ibre])
|
||||||
|
license are:
|
||||||
|
|
||||||
|
Commissariat à l'énergie atomique et aux énergies alternatives - CEA, a
|
||||||
|
public scientific, technical and industrial research establishment,
|
||||||
|
having its principal place of business at 25 rue Leblanc, immeuble Le
|
||||||
|
Ponant D, 75015 Paris, France.
|
||||||
|
|
||||||
|
Centre National de la Recherche Scientifique - CNRS, a public scientific
|
||||||
|
and technological establishment, having its principal place of business
|
||||||
|
at 3 rue Michel-Ange, 75794 Paris cedex 16, France.
|
||||||
|
|
||||||
|
Institut National de Recherche en Informatique et en Automatique -
|
||||||
|
Inria, a public scientific and technological establishment, having its
|
||||||
|
principal place of business at Domaine de Voluceau, Rocquencourt, BP
|
||||||
|
105, 78153 Le Chesnay cedex, France.
|
||||||
|
|
||||||
|
|
||||||
|
Preamble
|
||||||
|
|
||||||
|
The purpose of this Free Software license agreement is to grant users
|
||||||
|
the right to modify and redistribute the software governed by this
|
||||||
|
license within the framework of an open source distribution model.
|
||||||
|
|
||||||
|
The exercising of this right is conditional upon certain obligations for
|
||||||
|
users so as to preserve this status for all subsequent redistributions.
|
||||||
|
|
||||||
|
In consideration of access to the source code and the rights to copy,
|
||||||
|
modify and redistribute granted by the license, users are provided only
|
||||||
|
with a limited warranty and the software's author, the holder of the
|
||||||
|
economic rights, and the successive licensors only have limited liability.
|
||||||
|
|
||||||
|
In this respect, the risks associated with loading, using, modifying
|
||||||
|
and/or developing or reproducing the software by the user are brought to
|
||||||
|
the user's attention, given its Free Software status, which may make it
|
||||||
|
complicated to use, with the result that its use is reserved for
|
||||||
|
developers and experienced professionals having in-depth computer
|
||||||
|
knowledge. Users are therefore encouraged to load and test the
|
||||||
|
suitability of the software as regards their requirements in conditions
|
||||||
|
enabling the security of their systems and/or data to be ensured and,
|
||||||
|
more generally, to use and operate it in the same conditions of
|
||||||
|
security. This Agreement may be freely reproduced and published,
|
||||||
|
provided it is not altered, and that no provisions are either added or
|
||||||
|
removed herefrom.
|
||||||
|
|
||||||
|
This Agreement may apply to any or all software for which the holder of
|
||||||
|
the economic rights decides to submit the use thereof to its provisions.
|
||||||
|
|
||||||
|
Frequently asked questions can be found on the official website of the
|
||||||
|
CeCILL licenses family (http://www.cecill.info/index.en.html) for any
|
||||||
|
necessary clarification.
|
||||||
|
|
||||||
|
|
||||||
|
Article 1 - DEFINITIONS
|
||||||
|
|
||||||
|
For the purpose of this Agreement, when the following expressions
|
||||||
|
commence with a capital letter, they shall have the following meaning:
|
||||||
|
|
||||||
|
Agreement: means this license agreement, and its possible subsequent
|
||||||
|
versions and annexes.
|
||||||
|
|
||||||
|
Software: means the software in its Object Code and/or Source Code form
|
||||||
|
and, where applicable, its documentation, "as is" when the Licensee
|
||||||
|
accepts the Agreement.
|
||||||
|
|
||||||
|
Initial Software: means the Software in its Source Code and possibly its
|
||||||
|
Object Code form and, where applicable, its documentation, "as is" when
|
||||||
|
it is first distributed under the terms and conditions of the Agreement.
|
||||||
|
|
||||||
|
Modified Software: means the Software modified by at least one
|
||||||
|
Contribution.
|
||||||
|
|
||||||
|
Source Code: means all the Software's instructions and program lines to
|
||||||
|
which access is required so as to modify the Software.
|
||||||
|
|
||||||
|
Object Code: means the binary files originating from the compilation of
|
||||||
|
the Source Code.
|
||||||
|
|
||||||
|
Holder: means the holder(s) of the economic rights over the Initial
|
||||||
|
Software.
|
||||||
|
|
||||||
|
Licensee: means the Software user(s) having accepted the Agreement.
|
||||||
|
|
||||||
|
Contributor: means a Licensee having made at least one Contribution.
|
||||||
|
|
||||||
|
Licensor: means the Holder, or any other individual or legal entity, who
|
||||||
|
distributes the Software under the Agreement.
|
||||||
|
|
||||||
|
Contribution: means any or all modifications, corrections, translations,
|
||||||
|
adaptations and/or new functions integrated into the Software by any or
|
||||||
|
all Contributors, as well as any or all Internal Modules.
|
||||||
|
|
||||||
|
Module: means a set of sources files including their documentation that
|
||||||
|
enables supplementary functions or services in addition to those offered
|
||||||
|
by the Software.
|
||||||
|
|
||||||
|
External Module: means any or all Modules, not derived from the
|
||||||
|
Software, so that this Module and the Software run in separate address
|
||||||
|
spaces, with one calling the other when they are run.
|
||||||
|
|
||||||
|
Internal Module: means any or all Module, connected to the Software so
|
||||||
|
that they both execute in the same address space.
|
||||||
|
|
||||||
|
GNU GPL: means the GNU General Public License version 2 or any
|
||||||
|
subsequent version, as published by the Free Software Foundation Inc.
|
||||||
|
|
||||||
|
GNU Affero GPL: means the GNU Affero General Public License version 3 or
|
||||||
|
any subsequent version, as published by the Free Software Foundation Inc.
|
||||||
|
|
||||||
|
EUPL: means the European Union Public License version 1.1 or any
|
||||||
|
subsequent version, as published by the European Commission.
|
||||||
|
|
||||||
|
Parties: mean both the Licensee and the Licensor.
|
||||||
|
|
||||||
|
These expressions may be used both in singular and plural form.
|
||||||
|
|
||||||
|
|
||||||
|
Article 2 - PURPOSE
|
||||||
|
|
||||||
|
The purpose of the Agreement is the grant by the Licensor to the
|
||||||
|
Licensee of a non-exclusive, transferable and worldwide license for the
|
||||||
|
Software as set forth in Article 5 <#scope> hereinafter for the whole
|
||||||
|
term of the protection granted by the rights over said Software.
|
||||||
|
|
||||||
|
|
||||||
|
Article 3 - ACCEPTANCE
|
||||||
|
|
||||||
|
3.1 The Licensee shall be deemed as having accepted the terms and
|
||||||
|
conditions of this Agreement upon the occurrence of the first of the
|
||||||
|
following events:
|
||||||
|
|
||||||
|
* (i) loading the Software by any or all means, notably, by
|
||||||
|
downloading from a remote server, or by loading from a physical medium;
|
||||||
|
* (ii) the first time the Licensee exercises any of the rights granted
|
||||||
|
hereunder.
|
||||||
|
|
||||||
|
3.2 One copy of the Agreement, containing a notice relating to the
|
||||||
|
characteristics of the Software, to the limited warranty, and to the
|
||||||
|
fact that its use is restricted to experienced users has been provided
|
||||||
|
to the Licensee prior to its acceptance as set forth in Article 3.1
|
||||||
|
<#accepting> hereinabove, and the Licensee hereby acknowledges that it
|
||||||
|
has read and understood it.
|
||||||
|
|
||||||
|
|
||||||
|
Article 4 - EFFECTIVE DATE AND TERM
|
||||||
|
|
||||||
|
|
||||||
|
4.1 EFFECTIVE DATE
|
||||||
|
|
||||||
|
The Agreement shall become effective on the date when it is accepted by
|
||||||
|
the Licensee as set forth in Article 3.1 <#accepting>.
|
||||||
|
|
||||||
|
|
||||||
|
4.2 TERM
|
||||||
|
|
||||||
|
The Agreement shall remain in force for the entire legal term of
|
||||||
|
protection of the economic rights over the Software.
|
||||||
|
|
||||||
|
|
||||||
|
Article 5 - SCOPE OF RIGHTS GRANTED
|
||||||
|
|
||||||
|
The Licensor hereby grants to the Licensee, who accepts, the following
|
||||||
|
rights over the Software for any or all use, and for the term of the
|
||||||
|
Agreement, on the basis of the terms and conditions set forth hereinafter.
|
||||||
|
|
||||||
|
Besides, if the Licensor owns or comes to own one or more patents
|
||||||
|
protecting all or part of the functions of the Software or of its
|
||||||
|
components, the Licensor undertakes not to enforce the rights granted by
|
||||||
|
these patents against successive Licensees using, exploiting or
|
||||||
|
modifying the Software. If these patents are transferred, the Licensor
|
||||||
|
undertakes to have the transferees subscribe to the obligations set
|
||||||
|
forth in this paragraph.
|
||||||
|
|
||||||
|
|
||||||
|
5.1 RIGHT OF USE
|
||||||
|
|
||||||
|
The Licensee is authorized to use the Software, without any limitation
|
||||||
|
as to its fields of application, with it being hereinafter specified
|
||||||
|
that this comprises:
|
||||||
|
|
||||||
|
1. permanent or temporary reproduction of all or part of the Software
|
||||||
|
by any or all means and in any or all form.
|
||||||
|
|
||||||
|
2. loading, displaying, running, or storing the Software on any or all
|
||||||
|
medium.
|
||||||
|
|
||||||
|
3. entitlement to observe, study or test its operation so as to
|
||||||
|
determine the ideas and principles behind any or all constituent
|
||||||
|
elements of said Software. This shall apply when the Licensee
|
||||||
|
carries out any or all loading, displaying, running, transmission or
|
||||||
|
storage operation as regards the Software, that it is entitled to
|
||||||
|
carry out hereunder.
|
||||||
|
|
||||||
|
|
||||||
|
5.2 ENTITLEMENT TO MAKE CONTRIBUTIONS
|
||||||
|
|
||||||
|
The right to make Contributions includes the right to translate, adapt,
|
||||||
|
arrange, or make any or all modifications to the Software, and the right
|
||||||
|
to reproduce the resulting software.
|
||||||
|
|
||||||
|
The Licensee is authorized to make any or all Contributions to the
|
||||||
|
Software provided that it includes an explicit notice that it is the
|
||||||
|
author of said Contribution and indicates the date of the creation thereof.
|
||||||
|
|
||||||
|
|
||||||
|
5.3 RIGHT OF DISTRIBUTION
|
||||||
|
|
||||||
|
In particular, the right of distribution includes the right to publish,
|
||||||
|
transmit and communicate the Software to the general public on any or
|
||||||
|
all medium, and by any or all means, and the right to market, either in
|
||||||
|
consideration of a fee, or free of charge, one or more copies of the
|
||||||
|
Software by any means.
|
||||||
|
|
||||||
|
The Licensee is further authorized to distribute copies of the modified
|
||||||
|
or unmodified Software to third parties according to the terms and
|
||||||
|
conditions set forth hereinafter.
|
||||||
|
|
||||||
|
|
||||||
|
5.3.1 DISTRIBUTION OF SOFTWARE WITHOUT MODIFICATION
|
||||||
|
|
||||||
|
The Licensee is authorized to distribute true copies of the Software in
|
||||||
|
Source Code or Object Code form, provided that said distribution
|
||||||
|
complies with all the provisions of the Agreement and is accompanied by:
|
||||||
|
|
||||||
|
1. a copy of the Agreement,
|
||||||
|
|
||||||
|
2. a notice relating to the limitation of both the Licensor's warranty
|
||||||
|
and liability as set forth in Articles 8 and 9,
|
||||||
|
|
||||||
|
and that, in the event that only the Object Code of the Software is
|
||||||
|
redistributed, the Licensee allows effective access to the full Source
|
||||||
|
Code of the Software for a period of at least three years from the
|
||||||
|
distribution of the Software, it being understood that the additional
|
||||||
|
acquisition cost of the Source Code shall not exceed the cost of the
|
||||||
|
data transfer.
|
||||||
|
|
||||||
|
|
||||||
|
5.3.2 DISTRIBUTION OF MODIFIED SOFTWARE
|
||||||
|
|
||||||
|
When the Licensee makes a Contribution to the Software, the terms and
|
||||||
|
conditions for the distribution of the resulting Modified Software
|
||||||
|
become subject to all the provisions of this Agreement.
|
||||||
|
|
||||||
|
The Licensee is authorized to distribute the Modified Software, in
|
||||||
|
source code or object code form, provided that said distribution
|
||||||
|
complies with all the provisions of the Agreement and is accompanied by:
|
||||||
|
|
||||||
|
1. a copy of the Agreement,
|
||||||
|
|
||||||
|
2. a notice relating to the limitation of both the Licensor's warranty
|
||||||
|
and liability as set forth in Articles 8 and 9,
|
||||||
|
|
||||||
|
and, in the event that only the object code of the Modified Software is
|
||||||
|
redistributed,
|
||||||
|
|
||||||
|
3. a note stating the conditions of effective access to the full source
|
||||||
|
code of the Modified Software for a period of at least three years
|
||||||
|
from the distribution of the Modified Software, it being understood
|
||||||
|
that the additional acquisition cost of the source code shall not
|
||||||
|
exceed the cost of the data transfer.
|
||||||
|
|
||||||
|
|
||||||
|
5.3.3 DISTRIBUTION OF EXTERNAL MODULES
|
||||||
|
|
||||||
|
When the Licensee has developed an External Module, the terms and
|
||||||
|
conditions of this Agreement do not apply to said External Module, that
|
||||||
|
may be distributed under a separate license agreement.
|
||||||
|
|
||||||
|
|
||||||
|
5.3.4 COMPATIBILITY WITH OTHER LICENSES
|
||||||
|
|
||||||
|
The Licensee can include a code that is subject to the provisions of one
|
||||||
|
of the versions of the GNU GPL, GNU Affero GPL and/or EUPL in the
|
||||||
|
Modified or unmodified Software, and distribute that entire code under
|
||||||
|
the terms of the same version of the GNU GPL, GNU Affero GPL and/or EUPL.
|
||||||
|
|
||||||
|
The Licensee can include the Modified or unmodified Software in a code
|
||||||
|
that is subject to the provisions of one of the versions of the GNU GPL,
|
||||||
|
GNU Affero GPL and/or EUPL and distribute that entire code under the
|
||||||
|
terms of the same version of the GNU GPL, GNU Affero GPL and/or EUPL.
|
||||||
|
|
||||||
|
|
||||||
|
Article 6 - INTELLECTUAL PROPERTY
|
||||||
|
|
||||||
|
|
||||||
|
6.1 OVER THE INITIAL SOFTWARE
|
||||||
|
|
||||||
|
The Holder owns the economic rights over the Initial Software. Any or
|
||||||
|
all use of the Initial Software is subject to compliance with the terms
|
||||||
|
and conditions under which the Holder has elected to distribute its work
|
||||||
|
and no one shall be entitled to modify the terms and conditions for the
|
||||||
|
distribution of said Initial Software.
|
||||||
|
|
||||||
|
The Holder undertakes that the Initial Software will remain ruled at
|
||||||
|
least by this Agreement, for the duration set forth in Article 4.2 <#term>.
|
||||||
|
|
||||||
|
|
||||||
|
6.2 OVER THE CONTRIBUTIONS
|
||||||
|
|
||||||
|
The Licensee who develops a Contribution is the owner of the
|
||||||
|
intellectual property rights over this Contribution as defined by
|
||||||
|
applicable law.
|
||||||
|
|
||||||
|
|
||||||
|
6.3 OVER THE EXTERNAL MODULES
|
||||||
|
|
||||||
|
The Licensee who develops an External Module is the owner of the
|
||||||
|
intellectual property rights over this External Module as defined by
|
||||||
|
applicable law and is free to choose the type of agreement that shall
|
||||||
|
govern its distribution.
|
||||||
|
|
||||||
|
|
||||||
|
6.4 JOINT PROVISIONS
|
||||||
|
|
||||||
|
The Licensee expressly undertakes:
|
||||||
|
|
||||||
|
1. not to remove, or modify, in any manner, the intellectual property
|
||||||
|
notices attached to the Software;
|
||||||
|
|
||||||
|
2. to reproduce said notices, in an identical manner, in the copies of
|
||||||
|
the Software modified or not.
|
||||||
|
|
||||||
|
The Licensee undertakes not to directly or indirectly infringe the
|
||||||
|
intellectual property rights on the Software of the Holder and/or
|
||||||
|
Contributors, and to take, where applicable, vis-à-vis its staff, any
|
||||||
|
and all measures required to ensure respect of said intellectual
|
||||||
|
property rights of the Holder and/or Contributors.
|
||||||
|
|
||||||
|
|
||||||
|
Article 7 - RELATED SERVICES
|
||||||
|
|
||||||
|
7.1 Under no circumstances shall the Agreement oblige the Licensor to
|
||||||
|
provide technical assistance or maintenance services for the Software.
|
||||||
|
|
||||||
|
However, the Licensor is entitled to offer this type of services. The
|
||||||
|
terms and conditions of such technical assistance, and/or such
|
||||||
|
maintenance, shall be set forth in a separate instrument. Only the
|
||||||
|
Licensor offering said maintenance and/or technical assistance services
|
||||||
|
shall incur liability therefor.
|
||||||
|
|
||||||
|
7.2 Similarly, any Licensor is entitled to offer to its licensees, under
|
||||||
|
its sole responsibility, a warranty, that shall only be binding upon
|
||||||
|
itself, for the redistribution of the Software and/or the Modified
|
||||||
|
Software, under terms and conditions that it is free to decide. Said
|
||||||
|
warranty, and the financial terms and conditions of its application,
|
||||||
|
shall be subject of a separate instrument executed between the Licensor
|
||||||
|
and the Licensee.
|
||||||
|
|
||||||
|
|
||||||
|
Article 8 - LIABILITY
|
||||||
|
|
||||||
|
8.1 Subject to the provisions of Article 8.2, the Licensee shall be
|
||||||
|
entitled to claim compensation for any direct loss it may have suffered
|
||||||
|
from the Software as a result of a fault on the part of the relevant
|
||||||
|
Licensor, subject to providing evidence thereof.
|
||||||
|
|
||||||
|
8.2 The Licensor's liability is limited to the commitments made under
|
||||||
|
this Agreement and shall not be incurred as a result of in particular:
|
||||||
|
(i) loss due the Licensee's total or partial failure to fulfill its
|
||||||
|
obligations, (ii) direct or consequential loss that is suffered by the
|
||||||
|
Licensee due to the use or performance of the Software, and (iii) more
|
||||||
|
generally, any consequential loss. In particular the Parties expressly
|
||||||
|
agree that any or all pecuniary or business loss (i.e. loss of data,
|
||||||
|
loss of profits, operating loss, loss of customers or orders,
|
||||||
|
opportunity cost, any disturbance to business activities) or any or all
|
||||||
|
legal proceedings instituted against the Licensee by a third party,
|
||||||
|
shall constitute consequential loss and shall not provide entitlement to
|
||||||
|
any or all compensation from the Licensor.
|
||||||
|
|
||||||
|
|
||||||
|
Article 9 - WARRANTY
|
||||||
|
|
||||||
|
9.1 The Licensee acknowledges that the scientific and technical
|
||||||
|
state-of-the-art when the Software was distributed did not enable all
|
||||||
|
possible uses to be tested and verified, nor for the presence of
|
||||||
|
possible defects to be detected. In this respect, the Licensee's
|
||||||
|
attention has been drawn to the risks associated with loading, using,
|
||||||
|
modifying and/or developing and reproducing the Software which are
|
||||||
|
reserved for experienced users.
|
||||||
|
|
||||||
|
The Licensee shall be responsible for verifying, by any or all means,
|
||||||
|
the suitability of the product for its requirements, its good working
|
||||||
|
order, and for ensuring that it shall not cause damage to either persons
|
||||||
|
or properties.
|
||||||
|
|
||||||
|
9.2 The Licensor hereby represents, in good faith, that it is entitled
|
||||||
|
to grant all the rights over the Software (including in particular the
|
||||||
|
rights set forth in Article 5 <#scope>).
|
||||||
|
|
||||||
|
9.3 The Licensee acknowledges that the Software is supplied "as is" by
|
||||||
|
the Licensor without any other express or tacit warranty, other than
|
||||||
|
that provided for in Article 9.2 <#good-faith> and, in particular,
|
||||||
|
without any warranty as to its commercial value, its secured, safe,
|
||||||
|
innovative or relevant nature.
|
||||||
|
|
||||||
|
Specifically, the Licensor does not warrant that the Software is free
|
||||||
|
from any error, that it will operate without interruption, that it will
|
||||||
|
be compatible with the Licensee's own equipment and software
|
||||||
|
configuration, nor that it will meet the Licensee's requirements.
|
||||||
|
|
||||||
|
9.4 The Licensor does not either expressly or tacitly warrant that the
|
||||||
|
Software does not infringe any third party intellectual property right
|
||||||
|
relating to a patent, software or any other property right. Therefore,
|
||||||
|
the Licensor disclaims any and all liability towards the Licensee
|
||||||
|
arising out of any or all proceedings for infringement that may be
|
||||||
|
instituted in respect of the use, modification and redistribution of the
|
||||||
|
Software. Nevertheless, should such proceedings be instituted against
|
||||||
|
the Licensee, the Licensor shall provide it with technical and legal
|
||||||
|
expertise for its defense. Such technical and legal expertise shall be
|
||||||
|
decided on a case-by-case basis between the relevant Licensor and the
|
||||||
|
Licensee pursuant to a memorandum of understanding. The Licensor
|
||||||
|
disclaims any and all liability as regards the Licensee's use of the
|
||||||
|
name of the Software. No warranty is given as regards the existence of
|
||||||
|
prior rights over the name of the Software or as regards the existence
|
||||||
|
of a trademark.
|
||||||
|
|
||||||
|
|
||||||
|
Article 10 - TERMINATION
|
||||||
|
|
||||||
|
10.1 In the event of a breach by the Licensee of its obligations
|
||||||
|
hereunder, the Licensor may automatically terminate this Agreement
|
||||||
|
thirty (30) days after notice has been sent to the Licensee and has
|
||||||
|
remained ineffective.
|
||||||
|
|
||||||
|
10.2 A Licensee whose Agreement is terminated shall no longer be
|
||||||
|
authorized to use, modify or distribute the Software. However, any
|
||||||
|
licenses that it may have granted prior to termination of the Agreement
|
||||||
|
shall remain valid subject to their having been granted in compliance
|
||||||
|
with the terms and conditions hereof.
|
||||||
|
|
||||||
|
|
||||||
|
Article 11 - MISCELLANEOUS
|
||||||
|
|
||||||
|
|
||||||
|
11.1 EXCUSABLE EVENTS
|
||||||
|
|
||||||
|
Neither Party shall be liable for any or all delay, or failure to
|
||||||
|
perform the Agreement, that may be attributable to an event of force
|
||||||
|
majeure, an act of God or an outside cause, such as defective
|
||||||
|
functioning or interruptions of the electricity or telecommunications
|
||||||
|
networks, network paralysis following a virus attack, intervention by
|
||||||
|
government authorities, natural disasters, water damage, earthquakes,
|
||||||
|
fire, explosions, strikes and labor unrest, war, etc.
|
||||||
|
|
||||||
|
11.2 Any failure by either Party, on one or more occasions, to invoke
|
||||||
|
one or more of the provisions hereof, shall under no circumstances be
|
||||||
|
interpreted as being a waiver by the interested Party of its right to
|
||||||
|
invoke said provision(s) subsequently.
|
||||||
|
|
||||||
|
11.3 The Agreement cancels and replaces any or all previous agreements,
|
||||||
|
whether written or oral, between the Parties and having the same
|
||||||
|
purpose, and constitutes the entirety of the agreement between said
|
||||||
|
Parties concerning said purpose. No supplement or modification to the
|
||||||
|
terms and conditions hereof shall be effective as between the Parties
|
||||||
|
unless it is made in writing and signed by their duly authorized
|
||||||
|
representatives.
|
||||||
|
|
||||||
|
11.4 In the event that one or more of the provisions hereof were to
|
||||||
|
conflict with a current or future applicable act or legislative text,
|
||||||
|
said act or legislative text shall prevail, and the Parties shall make
|
||||||
|
the necessary amendments so as to comply with said act or legislative
|
||||||
|
text. All other provisions shall remain effective. Similarly, invalidity
|
||||||
|
of a provision of the Agreement, for any reason whatsoever, shall not
|
||||||
|
cause the Agreement as a whole to be invalid.
|
||||||
|
|
||||||
|
|
||||||
|
11.5 LANGUAGE
|
||||||
|
|
||||||
|
The Agreement is drafted in both French and English and both versions
|
||||||
|
are deemed authentic.
|
||||||
|
|
||||||
|
|
||||||
|
Article 12 - NEW VERSIONS OF THE AGREEMENT
|
||||||
|
|
||||||
|
12.1 Any person is authorized to duplicate and distribute copies of this
|
||||||
|
Agreement.
|
||||||
|
|
||||||
|
12.2 So as to ensure coherence, the wording of this Agreement is
|
||||||
|
protected and may only be modified by the authors of the License, who
|
||||||
|
reserve the right to periodically publish updates or new versions of the
|
||||||
|
Agreement, each with a separate number. These subsequent versions may
|
||||||
|
address new issues encountered by Free Software.
|
||||||
|
|
||||||
|
12.3 Any Software distributed under a given version of the Agreement may
|
||||||
|
only be subsequently distributed under the same version of the Agreement
|
||||||
|
or a subsequent version, subject to the provisions of Article 5.3.4
|
||||||
|
<#compatibility>.
|
||||||
|
|
||||||
|
|
||||||
|
Article 13 - GOVERNING LAW AND JURISDICTION
|
||||||
|
|
||||||
|
13.1 The Agreement is governed by French law. The Parties agree to
|
||||||
|
endeavor to seek an amicable solution to any disagreements or disputes
|
||||||
|
that may arise during the performance of the Agreement.
|
||||||
|
|
||||||
|
13.2 Failing an amicable solution within two (2) months as from their
|
||||||
|
occurrence, and unless emergency proceedings are necessary, the
|
||||||
|
disagreements or disputes shall be referred to the Paris Courts having
|
||||||
|
jurisdiction, by the more diligent Party.
|
||||||
@@ -1,109 +1,78 @@
|
|||||||
|
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
|
||||||
<!-- Copyright E. Bigeon (2014) -->
|
<modelVersion>4.0.0</modelVersion>
|
||||||
<!-- -->
|
<parent>
|
||||||
<!-- emmanuel@bigeon.fr -->
|
<groupId>net.bigeon.config</groupId>
|
||||||
<!-- -->
|
<artifactId>ebigeon-config</artifactId>
|
||||||
<!-- This software is a computer program whose purpose is to -->
|
<version>1.8.21</version>
|
||||||
<!-- Socket implementation of GCLC. -->
|
</parent>
|
||||||
<!-- -->
|
<groupId>net.bigeon.gclc</groupId>
|
||||||
<!-- This software is governed by the CeCILL license under French law and -->
|
<artifactId>socket</artifactId>
|
||||||
<!-- abiding by the rules of distribution of free software. You can use, -->
|
<version>1.1.14-SNAPSHOT</version>
|
||||||
<!-- modify and/or redistribute the software under the terms of the CeCILL -->
|
<packaging>jar</packaging>
|
||||||
<!-- license as circulated by CEA, CNRS and INRIA at the following URL -->
|
<name>GCLC Socket</name>
|
||||||
<!-- "http://www.cecill.info". -->
|
<description>Socket implementation of GCLC</description>
|
||||||
<!-- -->
|
<url>https://bigeon.net/projects/gclc.html</url>
|
||||||
<!-- As a counterpart to the access to the source code and rights to copy, -->
|
<inceptionYear>2016</inceptionYear>
|
||||||
<!-- modify and redistribute granted by the license, users are provided only -->
|
<organization>
|
||||||
<!-- with a limited warranty and the software's author, the holder of the -->
|
<name>Bigeon</name>
|
||||||
<!-- economic rights, and the successive licensors have only limited -->
|
<url>https://bigeon.net/</url>
|
||||||
<!-- liability. -->
|
</organization>
|
||||||
<!-- -->
|
<licenses>
|
||||||
<!-- In this respect, the user's attention is drawn to the risks associated -->
|
<license>
|
||||||
<!-- with loading, using, modifying and/or developing or reproducing the -->
|
<distribution>manual</distribution>
|
||||||
<!-- software by the user in light of its specific status of free software, -->
|
<name>CeCILL 2.1</name>
|
||||||
<!-- that may mean that it is complicated to manipulate, and that also -->
|
<url>https://cecill.info/licences/Licence_CeCILL_V2.1-en.html</url>
|
||||||
<!-- therefore means that it is reserved for developers and experienced -->
|
</license>
|
||||||
<!-- professionals having in-depth computer knowledge. Users are therefore -->
|
</licenses>
|
||||||
<!-- encouraged to load and test the software's suitability as regards their -->
|
<developers>
|
||||||
<!-- requirements in conditions enabling the security of their systems and/or -->
|
<developer>
|
||||||
<!-- data to be ensured and, more generally, to use and operate it in the -->
|
<email>emmanuel@bigeon.fr</email>
|
||||||
<!-- same conditions as regards security. -->
|
<name>Emmanuel Bigeon</name>
|
||||||
<!-- -->
|
<url>bigeon.net</url>
|
||||||
<!-- The fact that you are presently reading this means that you have had -->
|
<roles>
|
||||||
<!-- knowledge of the CeCILL license and that you accept its terms. -->
|
<role>PM</role>
|
||||||
|
</roles>
|
||||||
|
</developer>
|
||||||
<!-- Copyright E. Bigeon (2014) -->
|
</developers>
|
||||||
<!-- -->
|
<scm>
|
||||||
<!-- emmanuel@bigeon.fr -->
|
<developerConnection>scm:git:gogs@git.code.bigeon.net:emmanuel/gclc.git</developerConnection>
|
||||||
<!-- -->
|
<tag>HEAD</tag>
|
||||||
<!-- This software is a computer program whose purpose is to -->
|
</scm>
|
||||||
<!-- Defines the distribution repositories and basic setup for projects
|
<properties>
|
||||||
of Emmanuel Bigeon. -->
|
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
|
||||||
<!-- -->
|
<project.scm.id>git.code.bigeon.net</project.scm.id>
|
||||||
<!-- This software is governed by the CeCILL license under French law and -->
|
<license.licenseName>cecill_2.1</license.licenseName>
|
||||||
<!-- abiding by the rules of distribution of free software. You can use, -->
|
</properties>
|
||||||
<!-- modify and/or redistribute the software under the terms of the CeCILL -->
|
<dependencies>
|
||||||
<!-- license as circulated by CEA, CNRS and INRIA at the following URL -->
|
<dependency>
|
||||||
<!-- "http://www.cecill.info". -->
|
<groupId>net.bigeon</groupId>
|
||||||
<!-- -->
|
<artifactId>gclc</artifactId>
|
||||||
<!-- As a counterpart to the access to the source code and rights to copy, -->
|
<version>2.0.11</version>
|
||||||
<!-- modify and redistribute granted by the license, users are provided only -->
|
</dependency>
|
||||||
<!-- with a limited warranty and the software's author, the holder of the -->
|
<dependency>
|
||||||
<!-- economic rights, and the successive licensors have only limited -->
|
<groupId>net.bigeon</groupId>
|
||||||
<!-- liability. -->
|
<artifactId>smu</artifactId>
|
||||||
<!-- -->
|
<version>1.0.6</version>
|
||||||
<!-- In this respect, the user's attention is drawn to the risks associated -->
|
</dependency>
|
||||||
<!-- with loading, using, modifying and/or developing or reproducing the -->
|
<dependency>
|
||||||
<!-- software by the user in light of its specific status of free software, -->
|
<groupId>net.bigeon.test</groupId>
|
||||||
<!-- that may mean that it is complicated to manipulate, and that also -->
|
<artifactId>junitmt</artifactId>
|
||||||
<!-- therefore means that it is reserved for developers and experienced -->
|
<version>1.0.0</version>
|
||||||
<!-- professionals having in-depth computer knowledge. Users are therefore -->
|
<scope>test</scope>
|
||||||
<!-- encouraged to load and test the software's suitability as regards their -->
|
</dependency>
|
||||||
<!-- requirements in conditions enabling the security of their systems and/or -->
|
</dependencies>
|
||||||
<!-- data to be ensured and, more generally, to use and operate it in the -->
|
<reporting>
|
||||||
<!-- same conditions as regards security. -->
|
<plugins>
|
||||||
<!-- -->
|
<plugin>
|
||||||
<!-- The fact that you are presently reading this means that you have had -->
|
<groupId>org.apache.maven.plugins</groupId>
|
||||||
<!-- knowledge of the CeCILL license and that you accept its terms. -->
|
<artifactId>maven-javadoc-plugin</artifactId>
|
||||||
|
<version>2.10.3</version>
|
||||||
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
|
</plugin>
|
||||||
<modelVersion>4.0.0</modelVersion>
|
<plugin>
|
||||||
<artifactId>gclc-socket</artifactId>
|
<groupId>com.github.sevntu-checkstyle</groupId>
|
||||||
<version>1.0.7-SNAPSHOT</version>
|
<artifactId>dsm-maven-plugin</artifactId>
|
||||||
<packaging>jar</packaging>
|
<version>2.2.0</version>
|
||||||
<url>http://www.bigeon.fr/emmanuel</url>
|
</plugin>
|
||||||
<properties>
|
</plugins>
|
||||||
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
|
</reporting>
|
||||||
<project.scm.id>git.bigeon.net</project.scm.id>
|
</project>
|
||||||
</properties>
|
|
||||||
<dependencies>
|
|
||||||
<dependency>
|
|
||||||
<groupId>junit</groupId>
|
|
||||||
<artifactId>junit</artifactId>
|
|
||||||
<version>4.11</version>
|
|
||||||
<scope>test</scope>
|
|
||||||
</dependency>
|
|
||||||
<dependency>
|
|
||||||
<groupId>fr.bigeon</groupId>
|
|
||||||
<artifactId>gclc</artifactId>
|
|
||||||
<version>1.2.3</version>
|
|
||||||
</dependency>
|
|
||||||
<dependency>
|
|
||||||
<groupId>fr.bigeon</groupId>
|
|
||||||
<artifactId>smu</artifactId>
|
|
||||||
<version>0.0.4</version>
|
|
||||||
</dependency>
|
|
||||||
</dependencies>
|
|
||||||
<parent>
|
|
||||||
<groupId>fr.bigeon</groupId>
|
|
||||||
<artifactId>ebigeon-config</artifactId>
|
|
||||||
<version>1.7.0</version>
|
|
||||||
</parent>
|
|
||||||
<name>GCLC Socket</name>
|
|
||||||
<description>Socket implementation of GCLC</description>
|
|
||||||
<scm>
|
|
||||||
<developerConnection>scm:git:gogs@git.code.bigeon.net:emmanuel/gclc.git</developerConnection>
|
|
||||||
<tag>HEAD</tag>
|
|
||||||
</scm>
|
|
||||||
</project>
|
|
||||||
|
|||||||
@@ -1,77 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright E. Bigeon (2014)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* Socket implementation of GCLC.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
/**
|
|
||||||
* gclc-socket:fr.bigeon.gclc.socket.ConsoleRunnable.java
|
|
||||||
* Created on: Jun 1, 2016
|
|
||||||
*/
|
|
||||||
package fr.bigeon.gclc.socket;
|
|
||||||
|
|
||||||
import fr.bigeon.gclc.ConsoleApplication;
|
|
||||||
|
|
||||||
/** A runnable class that will actually have the application running.
|
|
||||||
*
|
|
||||||
* @author Emmanuel Bigeon */
|
|
||||||
public class ConsoleRunnable implements Runnable {
|
|
||||||
|
|
||||||
/** The actual application */
|
|
||||||
private final ConsoleApplication app;
|
|
||||||
/** The synchronization object */
|
|
||||||
private final Object promptingLock;
|
|
||||||
|
|
||||||
/** @param app the application
|
|
||||||
* @param promptingLock the synchronization object */
|
|
||||||
public ConsoleRunnable(ConsoleApplication app, Object promptingLock) {
|
|
||||||
super();
|
|
||||||
this.app = app;
|
|
||||||
this.promptingLock = promptingLock;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see java.lang.Runnable#run() */
|
|
||||||
@Override
|
|
||||||
public void run() {
|
|
||||||
app.start();
|
|
||||||
synchronized (promptingLock) {
|
|
||||||
// release all waiting elements before ending
|
|
||||||
promptingLock.notifyAll();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Stop the application (it will finish its current operation) */
|
|
||||||
public void stop() {
|
|
||||||
app.exit();
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
@@ -1,303 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright E. Bigeon (2014)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* Socket implementation of GCLC.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
package fr.bigeon.gclc.socket;
|
|
||||||
|
|
||||||
import java.io.BufferedReader;
|
|
||||||
import java.io.BufferedWriter;
|
|
||||||
import java.io.IOException;
|
|
||||||
import java.io.InputStreamReader;
|
|
||||||
import java.io.OutputStreamWriter;
|
|
||||||
import java.io.PipedInputStream;
|
|
||||||
import java.io.PipedOutputStream;
|
|
||||||
import java.io.PrintWriter;
|
|
||||||
import java.net.ServerSocket;
|
|
||||||
import java.net.Socket;
|
|
||||||
import java.net.SocketException;
|
|
||||||
import java.util.Arrays;
|
|
||||||
import java.util.logging.Level;
|
|
||||||
import java.util.logging.Logger;
|
|
||||||
|
|
||||||
import fr.bigeon.gclc.ConsoleApplication;
|
|
||||||
import fr.bigeon.gclc.manager.ConsoleManager;
|
|
||||||
import fr.bigeon.smu.StringEncoder;
|
|
||||||
|
|
||||||
/** This is a socket communicating console consoleManager
|
|
||||||
* <p>
|
|
||||||
* To use this application, the following flow should be used:
|
|
||||||
*
|
|
||||||
* <pre>
|
|
||||||
* SocketConsoleApplicationShell shell = new SocketConsoleApplicationShell();
|
|
||||||
* ConsoleApplication myApplication = new MyConsoleApplication(shell.getConsoleManager(), ...);
|
|
||||||
* shell.setApplication(myApplication);
|
|
||||||
* Thread th = new Thread(shell);
|
|
||||||
* th.start();
|
|
||||||
* </pre>
|
|
||||||
* <p>
|
|
||||||
* This will start the application in a separate thread. The application will be
|
|
||||||
* listening on the given socket and writing back on it. If this is all your
|
|
||||||
* application, you should then {@link Thread#join()} the thread to wait for the
|
|
||||||
* end of the execution.
|
|
||||||
*
|
|
||||||
* @author Emmanuel Bigeon */
|
|
||||||
public class SocketConsoleApplicationShell implements Runnable {
|
|
||||||
|
|
||||||
/**
|
|
||||||
*
|
|
||||||
*/
|
|
||||||
private static final String INTERRUPTION_WHILE_WORKING = "Interruption while application was working"; //$NON-NLS-1$
|
|
||||||
/** The end of line character */
|
|
||||||
protected static final String EOL = "\n"; //$NON-NLS-1$
|
|
||||||
/** The encoder */
|
|
||||||
private static final StringEncoder ENCODER = new StringEncoder("%", //$NON-NLS-1$
|
|
||||||
Arrays.asList(EOL));
|
|
||||||
/** The class logger */
|
|
||||||
private static final Logger LOGGER = Logger
|
|
||||||
.getLogger(SocketConsoleApplicationShell.class.getName());
|
|
||||||
/** The listening port */
|
|
||||||
private final int port;
|
|
||||||
/** The input */
|
|
||||||
private final PipedInputStream consoleInput = new PipedInputStream();
|
|
||||||
/** The application */
|
|
||||||
private ConsoleApplication app;
|
|
||||||
/** The session closing command */
|
|
||||||
private final String close;
|
|
||||||
/** The running status */
|
|
||||||
private boolean running;
|
|
||||||
/** An object to lock on for prompt */
|
|
||||||
private final Object promptingLock = new Object();
|
|
||||||
|
|
||||||
/** The console manager implementation */
|
|
||||||
private final ThreadedServerConsoleManager consoleManager = new ThreadedServerConsoleManager(
|
|
||||||
ENCODER, promptingLock);
|
|
||||||
/** The auto close flag. if this is true, every request closes the session
|
|
||||||
* after its call */
|
|
||||||
private final boolean autoClose;
|
|
||||||
/** The server socket */
|
|
||||||
private ServerSocket serverSocket;
|
|
||||||
/** The application shutdown string */
|
|
||||||
private final String applicationShutdown;
|
|
||||||
|
|
||||||
/** Create a socket application shell which will listen on the given port
|
|
||||||
* and close session upon the provided string reception by client
|
|
||||||
*
|
|
||||||
* @param port the port to listen to
|
|
||||||
* @param close the session closing command
|
|
||||||
* @param applicationShutdown the appication shut down command */
|
|
||||||
public SocketConsoleApplicationShell(int port, String close,
|
|
||||||
String applicationShutdown) {
|
|
||||||
this.port = port;
|
|
||||||
this.close = close;
|
|
||||||
this.applicationShutdown = applicationShutdown;
|
|
||||||
this.autoClose = false;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Create a socket application shell which will listen on the given port
|
|
||||||
* and auto close session after one instruction
|
|
||||||
*
|
|
||||||
* @param port the port to listen to
|
|
||||||
* @param autoClose if the session must be closed once the request has been
|
|
||||||
* sent
|
|
||||||
* @param applicationShutdown the application shutdown command */
|
|
||||||
public SocketConsoleApplicationShell(int port, boolean autoClose,
|
|
||||||
String applicationShutdown) {
|
|
||||||
this.port = port;
|
|
||||||
this.autoClose = autoClose;
|
|
||||||
this.applicationShutdown = applicationShutdown;
|
|
||||||
this.close = autoClose ? null : "close"; //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see java.lang.Runnable#run() */
|
|
||||||
@Override
|
|
||||||
public void run() {
|
|
||||||
// Create the server
|
|
||||||
try (ServerSocket actualServerSocket = new ServerSocket(port)) {
|
|
||||||
this.serverSocket = actualServerSocket;
|
|
||||||
running = true;
|
|
||||||
// Create the streams
|
|
||||||
try (PipedOutputStream outStream = new PipedOutputStream();
|
|
||||||
BufferedWriter writer = new BufferedWriter(
|
|
||||||
new OutputStreamWriter(outStream));
|
|
||||||
InputStreamReader isr = new InputStreamReader(consoleInput);
|
|
||||||
BufferedReader inBuf = new BufferedReader(isr)) {
|
|
||||||
consoleInput.connect(outStream);
|
|
||||||
consoleManager.setInput(inBuf);
|
|
||||||
runSokectServer(writer);
|
|
||||||
// Close the application
|
|
||||||
// Pass command to application
|
|
||||||
if (app.isRunning()) {
|
|
||||||
writer.write(applicationShutdown + EOL);
|
|
||||||
writer.flush();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
} catch (
|
|
||||||
|
|
||||||
final IOException e) {
|
|
||||||
LOGGER.log(Level.SEVERE,
|
|
||||||
"Communication error between client and server", e); //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param writer the writer to the application
|
|
||||||
* @throws IOException if the communication with the client failed */
|
|
||||||
private void runSokectServer(BufferedWriter writer) throws IOException {
|
|
||||||
final ConsoleRunnable runnable = new ConsoleRunnable(app,
|
|
||||||
promptingLock);
|
|
||||||
Thread appThOld = null;
|
|
||||||
Thread appThNext = new Thread(runnable);
|
|
||||||
while (running) {
|
|
||||||
try (Socket clientSocket = serverSocket.accept();
|
|
||||||
PrintWriter out = new PrintWriter(
|
|
||||||
clientSocket.getOutputStream(), true);
|
|
||||||
InputStreamReader isr = new InputStreamReader(
|
|
||||||
clientSocket.getInputStream());
|
|
||||||
BufferedReader in = new BufferedReader(isr);) {
|
|
||||||
// this is not threaded to avoid several clients at the same
|
|
||||||
// time
|
|
||||||
consoleManager.setOutput(out);
|
|
||||||
// Initiate application
|
|
||||||
if (appThOld == null || !appThOld.isAlive()) {
|
|
||||||
appThNext.start();
|
|
||||||
// Prepare next start
|
|
||||||
appThOld = appThNext;
|
|
||||||
appThNext = new Thread(runnable);
|
|
||||||
} else {
|
|
||||||
out.println("Reconnected"); //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
communicate(writer, in);
|
|
||||||
} catch (SocketException e) {
|
|
||||||
LOGGER.log(Level.INFO, "Socket closed", e); //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/** active communication between server and client
|
|
||||||
*
|
|
||||||
* @param writer the writer to the application
|
|
||||||
* @param in the input from the client
|
|
||||||
* @throws IOException if the communication failed */
|
|
||||||
private void communicate(BufferedWriter writer,
|
|
||||||
BufferedReader in) throws IOException {
|
|
||||||
synchronized (promptingLock) {
|
|
||||||
if (!consoleManager.isPrompting()) {
|
|
||||||
try {
|
|
||||||
// wait for application to finish its operation
|
|
||||||
promptingLock.wait();
|
|
||||||
} catch (final InterruptedException e) {
|
|
||||||
LOGGER.log(Level.SEVERE, INTERRUPTION_WHILE_WORKING, e);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if (autoClose) {
|
|
||||||
communicateOnce(in, writer);
|
|
||||||
} else {
|
|
||||||
communicateLoop(in, writer);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param in the input from the client
|
|
||||||
* @param writer the output to the client
|
|
||||||
* @throws IOException if the communication failed */
|
|
||||||
private void communicateOnce(BufferedReader in,
|
|
||||||
BufferedWriter writer) throws IOException {
|
|
||||||
String ln;
|
|
||||||
if ((ln = in.readLine()) != null) {
|
|
||||||
if (ln.equals(close)) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
// Pass command to application
|
|
||||||
writer.write(ln + EOL);
|
|
||||||
writer.flush();
|
|
||||||
try {
|
|
||||||
// Wait for application process to
|
|
||||||
// finish
|
|
||||||
promptingLock.wait();
|
|
||||||
} catch (final InterruptedException e) {
|
|
||||||
LOGGER.log(Level.SEVERE, INTERRUPTION_WHILE_WORKING, e);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param in the input from the client
|
|
||||||
* @param writer the output to the client
|
|
||||||
* @throws IOException if the communication failed */
|
|
||||||
private void communicateLoop(BufferedReader in,
|
|
||||||
BufferedWriter writer) throws IOException {
|
|
||||||
String ln;
|
|
||||||
while (app.isRunning() && (ln = in.readLine()) != null) {
|
|
||||||
if (ln.equals(close)) {
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
// Pass command to application
|
|
||||||
writer.write(ln + EOL);
|
|
||||||
writer.flush();
|
|
||||||
try {
|
|
||||||
// Wait for application process to
|
|
||||||
// finish
|
|
||||||
promptingLock.wait();
|
|
||||||
} catch (final InterruptedException e) {
|
|
||||||
LOGGER.log(Level.SEVERE, INTERRUPTION_WHILE_WORKING, e);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @return the consoleManager */
|
|
||||||
public synchronized ConsoleManager getConsoleManager() {
|
|
||||||
return consoleManager;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param app the application to set */
|
|
||||||
public synchronized void setApplication(ConsoleApplication app) {
|
|
||||||
this.app = app;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** This method will request the server to stop.
|
|
||||||
* <p>
|
|
||||||
* In most cases, this will terminate communication on every client. On some
|
|
||||||
* cases, the */
|
|
||||||
public void stop() {
|
|
||||||
running = false;
|
|
||||||
try {
|
|
||||||
serverSocket.close();
|
|
||||||
} catch (IOException e) {
|
|
||||||
LOGGER.log(Level.SEVERE, "Exception in closing socket server", e); //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
synchronized (promptingLock) {
|
|
||||||
promptingLock.notifyAll();
|
|
||||||
}
|
|
||||||
app.exit();
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
@@ -1,176 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright E. Bigeon (2014)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* Socket implementation of GCLC.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
/**
|
|
||||||
* gclc-socket:fr.bigeon.gclc.socket.ThreadedServerConsoleManager.java
|
|
||||||
* Created on: Jun 1, 2016
|
|
||||||
*/
|
|
||||||
package fr.bigeon.gclc.socket;
|
|
||||||
|
|
||||||
import java.io.BufferedReader;
|
|
||||||
import java.io.IOException;
|
|
||||||
import java.io.PrintWriter;
|
|
||||||
import java.util.logging.Level;
|
|
||||||
import java.util.logging.Logger;
|
|
||||||
|
|
||||||
import fr.bigeon.gclc.manager.ConsoleManager;
|
|
||||||
import fr.bigeon.smu.StringEncoder;
|
|
||||||
|
|
||||||
/** The console manager for socket communication
|
|
||||||
*
|
|
||||||
* @author Emmanuel Bigeon */
|
|
||||||
public class ThreadedServerConsoleManager implements ConsoleManager {
|
|
||||||
|
|
||||||
/** The eol character */
|
|
||||||
private static final String EOL = "\n"; //$NON-NLS-1$
|
|
||||||
/** The class logger */
|
|
||||||
private static final Logger LOGGER = Logger
|
|
||||||
.getLogger(ThreadedServerConsoleManager.class.getName());
|
|
||||||
/** The prompting sequence */
|
|
||||||
private String prompt = new String();
|
|
||||||
/** The buffer of data to send to the user */
|
|
||||||
private StringBuilder buffer = new StringBuilder();
|
|
||||||
/** The synchronized object */
|
|
||||||
private final Object promptingLock;
|
|
||||||
/** The output to write data comming from the application */
|
|
||||||
private PrintWriter output;
|
|
||||||
/** The encoder to encode data coming from the application */
|
|
||||||
private final StringEncoder encoder;
|
|
||||||
/** The input to wait data from the user */
|
|
||||||
private BufferedReader input;
|
|
||||||
/** the prompting status */
|
|
||||||
private boolean doPrompt;
|
|
||||||
/**
|
|
||||||
*
|
|
||||||
*/
|
|
||||||
private boolean closed = false;
|
|
||||||
|
|
||||||
/** Create the console manager.
|
|
||||||
*
|
|
||||||
* @param encoder the encoder for output
|
|
||||||
* @param promptingLock the synchronization object */
|
|
||||||
public ThreadedServerConsoleManager(StringEncoder encoder,
|
|
||||||
Object promptingLock) {
|
|
||||||
super();
|
|
||||||
this.encoder = encoder;
|
|
||||||
this.promptingLock = promptingLock;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param input the input to set */
|
|
||||||
public void setInput(BufferedReader input) {
|
|
||||||
this.input = input;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param output the output to set */
|
|
||||||
public void setOutput(PrintWriter output) {
|
|
||||||
this.output = output;
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public void setPrompt(String prompt) {
|
|
||||||
this.prompt = prompt;
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public String prompt(String message) {
|
|
||||||
buffer.append(message);
|
|
||||||
String userInput = new String();
|
|
||||||
boolean prompting = true;
|
|
||||||
while (prompting) {
|
|
||||||
// Send buffer content
|
|
||||||
output.println(encoder.encode(buffer.toString()));
|
|
||||||
try {
|
|
||||||
synchronized (promptingLock) {
|
|
||||||
doPrompt = true;
|
|
||||||
promptingLock.notify();
|
|
||||||
}
|
|
||||||
userInput = input.readLine();
|
|
||||||
doPrompt = false;
|
|
||||||
prompting = false;
|
|
||||||
} catch (final IOException e) {
|
|
||||||
LOGGER.log(Level.SEVERE, "input reading error", e); //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
}
|
|
||||||
// Renew buffer
|
|
||||||
buffer = new StringBuilder();
|
|
||||||
return userInput;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @return the prompting status */
|
|
||||||
public synchronized boolean isPrompting() {
|
|
||||||
return doPrompt;
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public String prompt() {
|
|
||||||
return prompt(prompt);
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public void println(String message) {
|
|
||||||
buffer.append(message + EOL);
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public void println() {
|
|
||||||
buffer.append(EOL);
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public void print(String text) {
|
|
||||||
buffer.append(text);
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public String getPrompt() {
|
|
||||||
return prompt;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.manager.ConsoleManager#close() */
|
|
||||||
@Override
|
|
||||||
public void close() throws IOException {
|
|
||||||
// Do nothing
|
|
||||||
this.closed = true;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.manager.ConsoleManager#isClosed() */
|
|
||||||
@Override
|
|
||||||
public boolean isClosed() {
|
|
||||||
return closed;
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
@@ -0,0 +1,100 @@
|
|||||||
|
/**
|
||||||
|
* gclc-socket:net.bigeon.gclc.socket.ConnexionManager.java
|
||||||
|
* Created on: Nov 18, 2017
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.socket;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* GCLC Socket
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2016 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import java.util.Collection;
|
||||||
|
|
||||||
|
/** A manager for connected elements.
|
||||||
|
* <p>
|
||||||
|
* Connected elements are given an identifier (unique) at connexion.
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon
|
||||||
|
* @param <T> the type of object connected */
|
||||||
|
public interface ConnexionManager<T> {
|
||||||
|
/** Add a connection in the name.
|
||||||
|
*
|
||||||
|
* @param handle the connected object
|
||||||
|
* @return the name */
|
||||||
|
String addConnexion(T handle);
|
||||||
|
|
||||||
|
/** Disconnect an element.
|
||||||
|
*
|
||||||
|
* @param id the element connection id
|
||||||
|
* @return the object being disconnected */
|
||||||
|
T disconnect(String id);
|
||||||
|
|
||||||
|
/** Get the connected object.
|
||||||
|
*
|
||||||
|
* @param id the connexion id
|
||||||
|
* @return the object */
|
||||||
|
T get(String id);
|
||||||
|
|
||||||
|
/** Get the connected elements' ids.
|
||||||
|
*
|
||||||
|
* @return the connected elements' ids */
|
||||||
|
Collection<String> getConnected();
|
||||||
|
|
||||||
|
/** Test if a connection is active.
|
||||||
|
*
|
||||||
|
* @param id the connexion id
|
||||||
|
* @return if the connection is active. */
|
||||||
|
boolean isConnected(String id);
|
||||||
|
|
||||||
|
/** Add a lock on the disconnection.
|
||||||
|
* <p>
|
||||||
|
* This lock will <strong>not</strong> prevent calls to
|
||||||
|
* {@link #disconnect(String)}. It will however stop them from completing after
|
||||||
|
* the effective disconnection of the specified connection.
|
||||||
|
* <p>
|
||||||
|
* Calls to {@link #releaseDisconnexionLock(String)} remove a lock (at a pace of
|
||||||
|
* one for one).
|
||||||
|
*
|
||||||
|
* @param id the connexion id */
|
||||||
|
void lockDisconnexion(String id);
|
||||||
|
|
||||||
|
/** Release one lock on a disconnection
|
||||||
|
*
|
||||||
|
* @param id the connexion being released. */
|
||||||
|
void releaseDisconnexionLock(String id);
|
||||||
|
|
||||||
|
/** Wait for calls to {@link #disconnect(String)}
|
||||||
|
*
|
||||||
|
* @param id the connexion id
|
||||||
|
* @throws InterruptedException if the wait was interrupted. */
|
||||||
|
void waitDisconnexion(String id) throws InterruptedException;
|
||||||
|
}
|
||||||
@@ -0,0 +1,175 @@
|
|||||||
|
/**
|
||||||
|
* gclc-socket:net.bigeon.gclc.socket.DConnexionManager.java
|
||||||
|
* Created on: Nov 18, 2017
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.socket;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* GCLC Socket
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2016 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import java.util.Collection;
|
||||||
|
import java.util.HashMap;
|
||||||
|
import java.util.Map;
|
||||||
|
import java.util.logging.Level;
|
||||||
|
import java.util.logging.Logger;
|
||||||
|
|
||||||
|
/** Default implementation of the {@link ConnexionManager}.
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon
|
||||||
|
* @param <T> the connected objects */
|
||||||
|
public final class DConnexionManager<T> implements ConnexionManager<T> {
|
||||||
|
|
||||||
|
/** Class logger. */
|
||||||
|
private static final Logger LOGGER = Logger
|
||||||
|
.getLogger(DConnexionManager.class.getName());
|
||||||
|
/** The connected objects. */
|
||||||
|
private final Map<String, T> connecteds = new HashMap<>();
|
||||||
|
/** The locks for the connexions. */
|
||||||
|
private final Map<String, Object> locks = new HashMap<>();
|
||||||
|
/** The counter for the disconnexion locks. */
|
||||||
|
private final Map<String, Integer> counters = new HashMap<>();
|
||||||
|
/** The lock for modification of {@link #counters}. */
|
||||||
|
private final Object counterLock = new Object();
|
||||||
|
/** The count of connexions. */
|
||||||
|
private int count;
|
||||||
|
|
||||||
|
/** Default.constructor. */
|
||||||
|
public DConnexionManager() {
|
||||||
|
//
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see
|
||||||
|
* net.bigeon.gclc.socket.ConnexionManager#addConnexion(java.lang.Object) */
|
||||||
|
@Override
|
||||||
|
public String addConnexion(final T handle) {
|
||||||
|
final String newID = newID();
|
||||||
|
connecteds.put(newID, handle);
|
||||||
|
locks.put(newID, new Object());
|
||||||
|
counters.put(newID, Integer.valueOf(0));
|
||||||
|
return newID;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.socket.ConnexionManager#disconnect(java.lang.String) */
|
||||||
|
@Override
|
||||||
|
public T disconnect(final String id) {
|
||||||
|
if (!connecteds.containsKey(id)) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
final T disc = connecteds.remove(id);
|
||||||
|
final Object lock = locks.get(id);
|
||||||
|
synchronized (lock) {
|
||||||
|
lock.notifyAll();
|
||||||
|
}
|
||||||
|
synchronized (counterLock) {
|
||||||
|
while (counters.get(id).intValue() > 0) {
|
||||||
|
try {
|
||||||
|
counterLock.wait();
|
||||||
|
} catch (final InterruptedException e) {
|
||||||
|
LOGGER.log(Level.FINE, "Interruption of thread", e); //$NON-NLS-1$
|
||||||
|
Thread.currentThread().interrupt();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return disc;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.socket.ConnexionManager#get(java.lang.String) */
|
||||||
|
@Override
|
||||||
|
public T get(final String id) {
|
||||||
|
return connecteds.get(id);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.socket.ConnexionManager#getConnected() */
|
||||||
|
@Override
|
||||||
|
public Collection<String> getConnected() {
|
||||||
|
return connecteds.keySet();
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.socket.ConnexionManager#isConnected(java.lang.String) */
|
||||||
|
@Override
|
||||||
|
public boolean isConnected(final String id) {
|
||||||
|
return connecteds.containsKey(id);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see
|
||||||
|
* net.bigeon.gclc.socket.ConnexionManager#lockDisconnexion(java.lang.String) */
|
||||||
|
@Override
|
||||||
|
public void lockDisconnexion(final String id) {
|
||||||
|
if (!connecteds.containsKey(id)) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
synchronized (counterLock) {
|
||||||
|
counters.put(id, Integer.valueOf(counters.get(id).intValue() + 1));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Get a new identifier for connexion.
|
||||||
|
*
|
||||||
|
* @return a new ID */
|
||||||
|
private String newID() {
|
||||||
|
final int c = count++;
|
||||||
|
return "Client " + c; //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see
|
||||||
|
* net.bigeon.gclc.socket.ConnexionManager#releaseDisconnexionLock(java.lang.
|
||||||
|
* String) */
|
||||||
|
@Override
|
||||||
|
public void releaseDisconnexionLock(final String id) {
|
||||||
|
synchronized (counterLock) {
|
||||||
|
counters.put(id,
|
||||||
|
Integer.valueOf(Math.max(counters.get(id).intValue() - 1, 0)));
|
||||||
|
counterLock.notifyAll();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see
|
||||||
|
* net.bigeon.gclc.socket.ConnexionManager#waitDisconnexion(java.lang.String) */
|
||||||
|
@Override
|
||||||
|
public void waitDisconnexion(final String id) throws InterruptedException {
|
||||||
|
final Object lock = locks.get(id);
|
||||||
|
while (connecteds.containsKey(id)) {
|
||||||
|
synchronized (lock) {
|
||||||
|
lock.wait();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,288 @@
|
|||||||
|
/**
|
||||||
|
* gclc-socket:net.bigeon.gclc.socket.PlugableConsoleInput.java
|
||||||
|
* Created on: Nov 18, 2017
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.socket;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* GCLC Socket
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2016 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import java.io.BufferedReader;
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.io.InputStream;
|
||||||
|
import java.io.InputStreamReader;
|
||||||
|
import java.io.PrintStream;
|
||||||
|
import java.nio.charset.StandardCharsets;
|
||||||
|
import java.util.logging.Level;
|
||||||
|
import java.util.logging.Logger;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.manager.ConsoleInput;
|
||||||
|
import net.bigeon.gclc.tools.ConstantString;
|
||||||
|
import net.bigeon.gclc.tools.StringProvider;
|
||||||
|
import net.bigeon.gclc.utils.ReadingRunnable;
|
||||||
|
|
||||||
|
/** A console input where the stream can be plugged.
|
||||||
|
* <p>
|
||||||
|
* This pluggable console input accepts an input and output to be connected to
|
||||||
|
* it. The connection cannot be concurrent, which mean that any connected stream
|
||||||
|
* must be disconnected before a new call to
|
||||||
|
* {@link #connect(InputStream, PrintStream)} is done.
|
||||||
|
* <p>
|
||||||
|
* On connection, if the prompt is in wait, this console input will provide the
|
||||||
|
* prompting message.
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public final class PluggableConsoleInput implements ConsoleInput {
|
||||||
|
/** The ten constant. */
|
||||||
|
private static final int TENTH = 10;
|
||||||
|
/** Class logger. */
|
||||||
|
private static final Logger LOGGER = Logger
|
||||||
|
.getLogger(PluggableConsoleInput.class.getName());
|
||||||
|
/** The default time out. */
|
||||||
|
private static final long TIMEOUT = 100;
|
||||||
|
/** The prompting. */
|
||||||
|
private boolean prompting = false;
|
||||||
|
/** If the element is closed. */
|
||||||
|
private boolean closed = false;
|
||||||
|
/** The default prompt. */
|
||||||
|
private StringProvider prompt = new ConstantString("> "); //$NON-NLS-1$
|
||||||
|
/** If the input is plugged or buffering. */
|
||||||
|
private boolean connected = false;
|
||||||
|
/** The current connexion (if any). */
|
||||||
|
private ReadingRunnable connexion;
|
||||||
|
/** The interrupted status for prompts. */
|
||||||
|
private boolean interrupted = false;
|
||||||
|
/** The last hint hint. */
|
||||||
|
private String hint;
|
||||||
|
/** The output for hints. */
|
||||||
|
private PrintStream output;
|
||||||
|
|
||||||
|
// Locks
|
||||||
|
/** The lock for connexion and disconnexion of actual streams. */
|
||||||
|
private final Object connexionLock = new Object();
|
||||||
|
|
||||||
|
/** Create the pluggable console input. */
|
||||||
|
public PluggableConsoleInput() {
|
||||||
|
// do nothing
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleInput#close() */
|
||||||
|
@Override
|
||||||
|
public void close() {
|
||||||
|
closed = true;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Connect the given input stream to the input and output to the hints writing.
|
||||||
|
*
|
||||||
|
* @param stream the input stream
|
||||||
|
* @param out the output for hints.
|
||||||
|
* @throws IOException if the input is already connected. */
|
||||||
|
public void connect(final InputStream stream, final PrintStream out)
|
||||||
|
throws IOException {
|
||||||
|
synchronized (connexionLock) {
|
||||||
|
if (connected) {
|
||||||
|
// Cannot be connected to several sources
|
||||||
|
throw new IOException("Input already connected to an input stream"); //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
output = out;
|
||||||
|
if (prompting) {
|
||||||
|
// print the hint, to indicate we are waiting for a user input.
|
||||||
|
out.print(hint);
|
||||||
|
out.flush();
|
||||||
|
}
|
||||||
|
final InputStreamReader streamReader = new InputStreamReader(stream,
|
||||||
|
StandardCharsets.UTF_8);
|
||||||
|
final BufferedReader reader = new BufferedReader(streamReader);
|
||||||
|
connexion = new ReadingRunnable(reader);
|
||||||
|
final Thread th = new Thread(connexion, "GCLC Socket - Read input"); //$NON-NLS-1$
|
||||||
|
th.start();
|
||||||
|
connexionLock.notifyAll();
|
||||||
|
connected = true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Disconnect the current input and hint output. */
|
||||||
|
public synchronized void disconnect() {
|
||||||
|
synchronized (connexionLock) {
|
||||||
|
if (!connected) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
connected = false;
|
||||||
|
connexion.setRunning(false);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleInput#getPrompt() */
|
||||||
|
@Override
|
||||||
|
public StringProvider getPrompt() {
|
||||||
|
return prompt;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleInput#interruptPrompt() */
|
||||||
|
@Override
|
||||||
|
public void interruptPrompt() {
|
||||||
|
interrupted = true;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleInput#isClosed() */
|
||||||
|
@Override
|
||||||
|
public boolean isClosed() {
|
||||||
|
return closed;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Test if a prompt is occuring.
|
||||||
|
*
|
||||||
|
* @return the prompting */
|
||||||
|
public boolean isPrompting() {
|
||||||
|
return prompting;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleInput#prompt() */
|
||||||
|
@Override
|
||||||
|
public String prompt() throws IOException {
|
||||||
|
return prompt(prompt.apply());
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleInput#prompt(long) */
|
||||||
|
@Override
|
||||||
|
public String prompt(final long timeout) throws IOException {
|
||||||
|
return prompt(prompt.apply(), timeout);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleInput#prompt(java.lang.String) */
|
||||||
|
@Override
|
||||||
|
public String prompt(final String message) throws IOException {
|
||||||
|
if (closed) {
|
||||||
|
throw new IOException();
|
||||||
|
}
|
||||||
|
preparePrompt(message);
|
||||||
|
String res = null;
|
||||||
|
while (res == null && !interrupted) {
|
||||||
|
try {
|
||||||
|
// Wait for a message or a connection with message
|
||||||
|
res = waitMessageOrConnexion(TIMEOUT, TIMEOUT / TENTH);
|
||||||
|
} catch (final InterruptedException e) {
|
||||||
|
LOGGER.log(Level.FINE, "Interruption of thread", e); //$NON-NLS-1$
|
||||||
|
Thread.currentThread().interrupt();
|
||||||
|
}
|
||||||
|
if (closed) {
|
||||||
|
throw new IOException();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
prompting = false;
|
||||||
|
return res;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Prepare the new prompt.
|
||||||
|
*
|
||||||
|
* @param message the message to indicate request of prompt. */
|
||||||
|
private void preparePrompt(final String message) {
|
||||||
|
prompting = true;
|
||||||
|
// hold the message
|
||||||
|
synchronized (connexionLock) {
|
||||||
|
hint = message;
|
||||||
|
if (connected) {
|
||||||
|
// print the message
|
||||||
|
output.print(message);
|
||||||
|
output.flush();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleInput#prompt(java.lang.String, long) */
|
||||||
|
@Override
|
||||||
|
public String prompt(final String message, final long timeout) throws IOException {
|
||||||
|
if (closed) {
|
||||||
|
throw new IOException();
|
||||||
|
}
|
||||||
|
preparePrompt(message);
|
||||||
|
String res = null;
|
||||||
|
final long tic = System.currentTimeMillis();
|
||||||
|
long time = System.currentTimeMillis() - tic;
|
||||||
|
while (res == null && !interrupted && time < timeout) {
|
||||||
|
try {
|
||||||
|
res = waitMessageOrConnexion(timeout - time, (timeout - time) / TENTH);
|
||||||
|
} catch (final InterruptedException e) {
|
||||||
|
LOGGER.log(Level.FINE, "Interruption of thread", e); //$NON-NLS-1$
|
||||||
|
Thread.currentThread().interrupt();
|
||||||
|
}
|
||||||
|
time = System.currentTimeMillis() - tic;
|
||||||
|
if (closed) {
|
||||||
|
throw new IOException();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
prompting = false;
|
||||||
|
return res;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.manager.ConsoleInput#setPrompt(java.lang.String) */
|
||||||
|
@Override
|
||||||
|
public void setPrompt(final String prompt) {
|
||||||
|
setPrompt(new ConstantString(prompt));
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.manager.ConsoleInput#setPrompt(net.bigeon.gclc.tools.
|
||||||
|
* StringProvider) */
|
||||||
|
@Override
|
||||||
|
public void setPrompt(final StringProvider prompt) {
|
||||||
|
this.prompt = prompt;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Wait for a hint or connection.
|
||||||
|
*
|
||||||
|
* @param messageTimeout the timeout on the current connection hint waiting
|
||||||
|
* @param connexionTimeout the timeout on the new connection wait
|
||||||
|
* @return the hint, or null if not connected or timed out.
|
||||||
|
* @throws IOException if the reading failed.
|
||||||
|
* @throws InterruptedException if the wait was interrupted */
|
||||||
|
private String waitMessageOrConnexion(final long messageTimeout,
|
||||||
|
final long connexionTimeout) throws IOException, InterruptedException {
|
||||||
|
synchronized (connexionLock) {
|
||||||
|
if (connected) {
|
||||||
|
return connexion.getNextMessage(messageTimeout);
|
||||||
|
}
|
||||||
|
connexionLock.wait(connexionTimeout);
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,129 @@
|
|||||||
|
/**
|
||||||
|
* gclc-socket:net.bigeon.gclc.socket.PluggableConsoleOutput.java
|
||||||
|
* Created on: Nov 18, 2017
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.socket;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* GCLC Socket
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2016 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.io.PrintStream;
|
||||||
|
import java.util.ArrayDeque;
|
||||||
|
import java.util.Deque;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.manager.ConsoleOutput;
|
||||||
|
|
||||||
|
/** An output that can be hotplugged to an actual output.
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public final class PluggableConsoleOutput implements ConsoleOutput {
|
||||||
|
|
||||||
|
/** The actual output. */
|
||||||
|
private PrintStream out;
|
||||||
|
/** The buffered messages. */
|
||||||
|
private final Deque<String> messages = new ArrayDeque<>();
|
||||||
|
/** If this output is closed. */
|
||||||
|
private boolean closed = false;
|
||||||
|
|
||||||
|
/** Default constructor. */
|
||||||
|
public PluggableConsoleOutput() {
|
||||||
|
//
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see java.lang.AutoCloseable#close() */
|
||||||
|
@Override
|
||||||
|
public void close() {
|
||||||
|
closed = true;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Set the output to write to.
|
||||||
|
*
|
||||||
|
* @param output the output to set */
|
||||||
|
public synchronized void connect(final PrintStream output) {
|
||||||
|
out = output;
|
||||||
|
while (!messages.isEmpty()) {
|
||||||
|
output.print(messages.pop());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Disconnects the output. */
|
||||||
|
public synchronized void disconnect() {
|
||||||
|
out = null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleOutput#isClosed() */
|
||||||
|
@Override
|
||||||
|
public boolean isClosed() {
|
||||||
|
return closed;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleOutput#print(java.lang.String) */
|
||||||
|
@Override
|
||||||
|
public synchronized void print(final String text) throws IOException {
|
||||||
|
if (closed) {
|
||||||
|
throw new IOException("Closed output"); //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
if (out == null) {
|
||||||
|
messages.add(text);
|
||||||
|
} else {
|
||||||
|
out.print(text);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleOutput#println() */
|
||||||
|
@Override
|
||||||
|
public synchronized void println() throws IOException {
|
||||||
|
if (closed) {
|
||||||
|
throw new IOException("Closed output"); //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
if (out == null) {
|
||||||
|
messages.add("\n"); //$NON-NLS-1$
|
||||||
|
} else {
|
||||||
|
out.println();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleOutput#println(java.lang.String) */
|
||||||
|
@Override
|
||||||
|
public synchronized void println(final String message) throws IOException {
|
||||||
|
print(message);
|
||||||
|
println();
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
@@ -0,0 +1,129 @@
|
|||||||
|
/**
|
||||||
|
* gclc-socket:net.bigeon.gclc.socket.RemoteDisconnectCommand.java
|
||||||
|
* Created on: Nov 18, 2017
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.socket;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* GCLC Socket
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2016 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.text.MessageFormat;
|
||||||
|
import java.util.Collection;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.command.Command;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunException;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunExceptionType;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleInput;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleOutput;
|
||||||
|
|
||||||
|
/** A {@link Command} to disconnect elements from a {@link ConnexionManager}.
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon
|
||||||
|
* @param <T> the type of connected object */
|
||||||
|
public final class RemoteDisconnectCommand<T> extends Command {
|
||||||
|
|
||||||
|
/** The connexion manager. */
|
||||||
|
private final ConnexionManager<T> manager;
|
||||||
|
/** If all connexion should be disconnected when no argument have been
|
||||||
|
* specified. */
|
||||||
|
private final boolean all;
|
||||||
|
|
||||||
|
/** Create the disconnection command.
|
||||||
|
*
|
||||||
|
* @param name the command name
|
||||||
|
* @param manager the manager
|
||||||
|
* @param all if all elements should be disconnected when no argument is
|
||||||
|
* provided */
|
||||||
|
public RemoteDisconnectCommand(final String name, final ConnexionManager<T> manager,
|
||||||
|
final boolean all) {
|
||||||
|
super(name);
|
||||||
|
this.manager = manager;
|
||||||
|
this.all = all;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.ICommand#execute(fr.bigeon.gclc.manager.
|
||||||
|
* ConsoleOutput, fr.bigeon.gclc.manager.ConsoleInput, java.lang.String[]) */
|
||||||
|
@Override
|
||||||
|
public void execute(final ConsoleOutput out, final ConsoleInput in,
|
||||||
|
final String... args) throws CommandRunException {
|
||||||
|
if (args.length == 0 && all) {
|
||||||
|
final Collection<String> coll = manager.getConnected();
|
||||||
|
for (final String string : coll) {
|
||||||
|
manager.disconnect(string);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
for (final String string : args) {
|
||||||
|
if (manager.isConnected(string)) {
|
||||||
|
manager.disconnect(string);
|
||||||
|
} else {
|
||||||
|
print(out,
|
||||||
|
MessageFormat.format("[WARNING] {0} is not connected", string)); //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Print a message if the output is defined.
|
||||||
|
*
|
||||||
|
* @param out the output
|
||||||
|
* @param string the message
|
||||||
|
* @throws CommandRunException if the output exists but cannot be printed to */
|
||||||
|
private static void print(final ConsoleOutput out, final String string)
|
||||||
|
throws CommandRunException {
|
||||||
|
if (out != null) {
|
||||||
|
try {
|
||||||
|
out.println(string);
|
||||||
|
} catch (final IOException e) {
|
||||||
|
throw new CommandRunException(CommandRunExceptionType.INTERACTION,
|
||||||
|
"Unable to print to existing output", e); //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.ICommand#tip() */
|
||||||
|
@Override
|
||||||
|
public String tip() {
|
||||||
|
return "Close a connexion."; //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.Command#usageDetail() */
|
||||||
|
@Override
|
||||||
|
protected String usageDetail() {
|
||||||
|
return MessageFormat.format(
|
||||||
|
" If arguments are provided the corresponding connexions are closed, otherwise\n{0} are.",
|
||||||
|
all ? "all connexions" : "none");
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,197 @@
|
|||||||
|
package net.bigeon.gclc.socket;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* GCLC Socket
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2016 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.net.InetAddress;
|
||||||
|
import java.net.ServerSocket;
|
||||||
|
import java.net.Socket;
|
||||||
|
import java.net.SocketException;
|
||||||
|
import java.util.logging.Level;
|
||||||
|
import java.util.logging.Logger;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.ConsoleApplication;
|
||||||
|
|
||||||
|
/** This is a socket communicating console consoleManager.
|
||||||
|
* <p>
|
||||||
|
* To use this application, the following flow should be used:
|
||||||
|
*
|
||||||
|
* <pre>
|
||||||
|
* SocketConsoleApplicationShell shell = new SocketConsoleApplicationShell();
|
||||||
|
* ConsoleApplication myApplication = new MyConsoleApplication(shell.getConsoleManager(), ...);
|
||||||
|
* shell.setApplication(myApplication);
|
||||||
|
* Thread th = new Thread(shell);
|
||||||
|
* th.start();
|
||||||
|
* </pre>
|
||||||
|
* <p>
|
||||||
|
* This will start the application in a separate thread. The application will be
|
||||||
|
* listening on the given socket and writing back on it. If this is all your
|
||||||
|
* application, you should then {@link Thread#join()} the thread to wait for the
|
||||||
|
* end of the execution.
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public final class SocketConsoleApplicationShell implements Runnable {
|
||||||
|
|
||||||
|
/** The class logger. */
|
||||||
|
private static final Logger LOGGER = Logger
|
||||||
|
.getLogger(SocketConsoleApplicationShell.class.getName());
|
||||||
|
/** The listening port. */
|
||||||
|
private final int port;
|
||||||
|
/** The running status. */
|
||||||
|
private boolean running;
|
||||||
|
/** The socket console interface. */
|
||||||
|
private SocketConsoleInterface sci;
|
||||||
|
/** The remote disconnection command. */
|
||||||
|
private ConnexionManager<Socket> rdc;
|
||||||
|
/** The application. */
|
||||||
|
private ConsoleApplication app;
|
||||||
|
|
||||||
|
/** The server socket. */
|
||||||
|
private ServerSocket serverSocket;
|
||||||
|
/** THe server address. */
|
||||||
|
private final InetAddress addr;
|
||||||
|
|
||||||
|
/** Create a socket application shell which will listen on the given port and
|
||||||
|
* network interface.
|
||||||
|
*
|
||||||
|
* @param port the part
|
||||||
|
* @param addr the inet address */
|
||||||
|
public SocketConsoleApplicationShell(final int port, final InetAddress addr) {
|
||||||
|
super();
|
||||||
|
this.port = port;
|
||||||
|
this.addr = addr;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Wait for the identified connection to disconnect.
|
||||||
|
*
|
||||||
|
* @param id the connexion id. */
|
||||||
|
private void awaitDisconnexion(final String id) {
|
||||||
|
while (rdc.isConnected(id)) {
|
||||||
|
try {
|
||||||
|
rdc.waitDisconnexion(id);
|
||||||
|
} catch (final InterruptedException e) {
|
||||||
|
LOGGER.log(Level.SEVERE, "Unexpected interruption", e); //$NON-NLS-1$
|
||||||
|
Thread.currentThread().interrupt();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
sci.disconnect();
|
||||||
|
}
|
||||||
|
|
||||||
|
/** If the port provided was 0, this allows to get the actual port.
|
||||||
|
*
|
||||||
|
* @return the local port
|
||||||
|
* @see java.net.ServerSocket#getLocalPort() */
|
||||||
|
public int getLocalPort() {
|
||||||
|
return serverSocket.getLocalPort();
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see java.lang.Runnable#run() */
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
// Create the server
|
||||||
|
try (ServerSocket actualServerSocket = new ServerSocket(port, 1, addr)) {
|
||||||
|
serverSocket = actualServerSocket;
|
||||||
|
running = true;
|
||||||
|
// Create the streams
|
||||||
|
runSokectServer();
|
||||||
|
} catch (final IOException e) {
|
||||||
|
LOGGER.severe("Communication error between client and server"); //$NON-NLS-1$
|
||||||
|
LOGGER.log(Level.FINE, "Communication error between client and server", e); //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Acctually run the server loop on connexion.
|
||||||
|
*
|
||||||
|
* @throws IOException if the communication with the client failed */
|
||||||
|
private void runSokectServer() throws IOException {
|
||||||
|
while (running && app.isRunning()) {
|
||||||
|
LOGGER.info("Waiting client"); //$NON-NLS-1$
|
||||||
|
try (Socket clientSocket = serverSocket.accept()) {
|
||||||
|
|
||||||
|
sci.connect(clientSocket);
|
||||||
|
|
||||||
|
final String id = rdc.addConnexion(clientSocket);
|
||||||
|
rdc.lockDisconnexion(id);
|
||||||
|
awaitDisconnexion(id);
|
||||||
|
rdc.releaseDisconnexionLock(id);
|
||||||
|
} catch (final SocketException e) {
|
||||||
|
LOGGER.log(Level.INFO, "Socket closed"); //$NON-NLS-1$
|
||||||
|
LOGGER.log(Level.FINE,
|
||||||
|
"Socket closed with exception (probably due to server interruption)", //$NON-NLS-1$
|
||||||
|
e);
|
||||||
|
} catch (final IOException e) {
|
||||||
|
throw e;
|
||||||
|
}
|
||||||
|
LOGGER.info("Closing client"); //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
LOGGER.info("Closing Server"); //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Set the application.
|
||||||
|
* <p>
|
||||||
|
* If the application is closed, the server will also close.
|
||||||
|
*
|
||||||
|
* @param app the app to set */
|
||||||
|
public void setApplication(final ConsoleApplication app) {
|
||||||
|
this.app = app;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Set the connexion manager.
|
||||||
|
*
|
||||||
|
* @param rdc the rdc to set */
|
||||||
|
public void setConnexionManager(final ConnexionManager<Socket> rdc) {
|
||||||
|
this.rdc = rdc;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Set the socket console interface.
|
||||||
|
*
|
||||||
|
* @param sci the console interface to set */
|
||||||
|
public void setInterface(final SocketConsoleInterface sci) {
|
||||||
|
this.sci = sci;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** This method will request the server to stop.
|
||||||
|
* <p>
|
||||||
|
* In most cases, this will terminate communication on every client. On some
|
||||||
|
* cases, the */
|
||||||
|
public void stop() {
|
||||||
|
running = false;
|
||||||
|
try {
|
||||||
|
serverSocket.close();
|
||||||
|
} catch (final IOException e) {
|
||||||
|
LOGGER.log(Level.SEVERE, "Exception in closing socket server", e); //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,82 @@
|
|||||||
|
/**
|
||||||
|
* gclc-socket:net.bigeon.gclc.socket.SocketConsoleInterface.java
|
||||||
|
* Created on: Nov 18, 2017
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.socket;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* GCLC Socket
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2016 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.io.PrintStream;
|
||||||
|
import java.net.Socket;
|
||||||
|
import java.nio.charset.StandardCharsets;
|
||||||
|
|
||||||
|
/** The interface for socket based access to console application.
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public final class SocketConsoleInterface {
|
||||||
|
|
||||||
|
/** The application's input. */
|
||||||
|
private final PluggableConsoleInput input;
|
||||||
|
/** The application's output. */
|
||||||
|
private final PluggableConsoleOutput output;
|
||||||
|
|
||||||
|
/** Create the interfacing object.
|
||||||
|
*
|
||||||
|
* @param input the input
|
||||||
|
* @param output the output */
|
||||||
|
public SocketConsoleInterface(final PluggableConsoleInput input,
|
||||||
|
final PluggableConsoleOutput output) {
|
||||||
|
super();
|
||||||
|
this.input = input;
|
||||||
|
this.output = output;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Connect the application's input and outputs to the socket's.
|
||||||
|
*
|
||||||
|
* @param socket the socket
|
||||||
|
* @throws IOException if the connection failed */
|
||||||
|
public void connect(final Socket socket) throws IOException {
|
||||||
|
final PrintStream printStream = new PrintStream(socket.getOutputStream(), true,
|
||||||
|
StandardCharsets.UTF_8.name());
|
||||||
|
output.connect(printStream);
|
||||||
|
input.connect(socket.getInputStream(), printStream);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Disconnect the input and output of the application from the socket's. */
|
||||||
|
public void disconnect() {
|
||||||
|
input.disconnect();
|
||||||
|
output.disconnect();
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,57 +1,39 @@
|
|||||||
/*
|
/** This package define a framework to access
|
||||||
* Copyright E. Bigeon (2015)
|
* {@link net.bigeon.gclc.ConsoleApplication} through a socket.
|
||||||
*
|
*
|
||||||
* emmanuel@bigeon.fr
|
* @author Emmanuel Bigeon */
|
||||||
*
|
package net.bigeon.gclc.socket;
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* provide a swt window for console applications.
|
/*-
|
||||||
*
|
* #%L
|
||||||
* This software is governed by the CeCILL license under French law and
|
* GCLC Socket
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
* %%
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
* Copyright (C) 2016 - 2018 Bigeon
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
* %%
|
||||||
* "http://www.cecill.info".
|
* This software is governed by the CeCILL license under French law and
|
||||||
*
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
* modify and redistribute granted by the license, users are provided only
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
* with a limited warranty and the software's author, the holder of the
|
* "http://www.cecill.info".
|
||||||
* economic rights, and the successive licensors have only limited
|
*
|
||||||
* liability.
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
*
|
* modify and redistribute granted by the license, users are provided only
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
* with a limited warranty and the software's author, the holder of the
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
* economic rights, and the successive licensors have only limited
|
||||||
* software by the user in light of its specific status of free software,
|
* liability.
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
*
|
||||||
* therefore means that it is reserved for developers and experienced
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
* encouraged to load and test the software's suitability as regards their
|
* software by the user in light of its specific status of free software,
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
* therefore means that it is reserved for developers and experienced
|
||||||
* same conditions as regards security.
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
*
|
* encouraged to load and test the software's suitability as regards their
|
||||||
* The fact that you are presently reading this means that you have had
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
*/
|
* same conditions as regards security.
|
||||||
/**
|
*
|
||||||
* gclc-swt:fr.bigeon.gclc.swt.HistoryTextKeyListenerTest.java
|
* The fact that you are presently reading this means that you have had
|
||||||
* Created on: Jun 9, 2016
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
*/
|
* #L%
|
||||||
package fr.bigeon.gclc.swt;
|
*/
|
||||||
|
|
||||||
import org.junit.Test;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* <p>
|
|
||||||
* TODO
|
|
||||||
*
|
|
||||||
* @author Emmanuel Bigeon
|
|
||||||
*
|
|
||||||
*/
|
|
||||||
public class HistoryTextKeyListenerTest {
|
|
||||||
|
|
||||||
@Test
|
|
||||||
public void test() {
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
44
gclc-socket/src/site/site.xml
Normal file
44
gclc-socket/src/site/site.xml
Normal file
@@ -0,0 +1,44 @@
|
|||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<!--
|
||||||
|
#%L
|
||||||
|
Generic Command Ligne console
|
||||||
|
%%
|
||||||
|
Copyright (C) 2014 - 2018 Bigeon
|
||||||
|
%%
|
||||||
|
This software is governed by the CeCILL license under French law and
|
||||||
|
abiding by the rules of distribution of free software. You can use,
|
||||||
|
modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
"http://www.cecill.info".
|
||||||
|
|
||||||
|
As a counterpart to the access to the source code and rights to copy,
|
||||||
|
modify and redistribute granted by the license, users are provided only
|
||||||
|
with a limited warranty and the software's author, the holder of the
|
||||||
|
economic rights, and the successive licensors have only limited
|
||||||
|
liability.
|
||||||
|
|
||||||
|
In this respect, the user's attention is drawn to the risks associated
|
||||||
|
with loading, using, modifying and/or developing or reproducing the
|
||||||
|
software by the user in light of its specific status of free software,
|
||||||
|
that may mean that it is complicated to manipulate, and that also
|
||||||
|
therefore means that it is reserved for developers and experienced
|
||||||
|
professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
encouraged to load and test the software's suitability as regards their
|
||||||
|
requirements in conditions enabling the security of their systems and/or
|
||||||
|
data to be ensured and, more generally, to use and operate it in the
|
||||||
|
same conditions as regards security.
|
||||||
|
|
||||||
|
The fact that you are presently reading this means that you have had
|
||||||
|
knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
#L%
|
||||||
|
-->
|
||||||
|
|
||||||
|
<project name="GCLC">
|
||||||
|
<bannerRight>
|
||||||
|
<src>https://bigeon.net/images/logo_48.png</src>
|
||||||
|
<href>https://bigeon.net/</href>
|
||||||
|
</bannerRight>
|
||||||
|
<body>
|
||||||
|
<menu ref="reports"/>
|
||||||
|
</body>
|
||||||
|
</project>
|
||||||
@@ -1,181 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright E. Bigeon (2014)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* Socket implementation of GCLC.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
/**
|
|
||||||
* gclc-socket:fr.bigeon.gclc.socket.ConsoleRunnableTest.java
|
|
||||||
* Created on: Jun 1, 2016
|
|
||||||
*/
|
|
||||||
package fr.bigeon.gclc.socket;
|
|
||||||
|
|
||||||
import java.io.IOException;
|
|
||||||
|
|
||||||
import org.junit.Test;
|
|
||||||
|
|
||||||
import fr.bigeon.gclc.ConsoleApplication;
|
|
||||||
import fr.bigeon.gclc.manager.ConsoleManager;
|
|
||||||
import fr.bigeon.gclc.manager.SystemConsoleManager;
|
|
||||||
|
|
||||||
/** Test class for {@link ConsoleRunnable}
|
|
||||||
*
|
|
||||||
* @author Emmanuel Bigeon */
|
|
||||||
@SuppressWarnings({"static-method", "unused", "javadoc"})
|
|
||||||
public class ConsoleRunnableTest {
|
|
||||||
|
|
||||||
/** <p>
|
|
||||||
* TODO
|
|
||||||
*
|
|
||||||
* @author Emmanuel Bigeon */
|
|
||||||
private static final class ConsoleManagerTestImplementation
|
|
||||||
implements ConsoleManager {
|
|
||||||
int i = 0;
|
|
||||||
String[] cmds;
|
|
||||||
|
|
||||||
/** @param cmds */
|
|
||||||
public ConsoleManagerTestImplementation(String[] cmds) {
|
|
||||||
super();
|
|
||||||
this.cmds = cmds;
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public void setPrompt(String prompt) {
|
|
||||||
// do nothing
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public String getPrompt() {
|
|
||||||
// Not used in test
|
|
||||||
return ""; //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public String prompt() {
|
|
||||||
try {
|
|
||||||
Thread.sleep(1000);
|
|
||||||
} catch (InterruptedException e) { // NOSONAR
|
|
||||||
// do nothing
|
|
||||||
}
|
|
||||||
i++;
|
|
||||||
if (i == cmds.length) {
|
|
||||||
i = 0;
|
|
||||||
}
|
|
||||||
return cmds[i];
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public String prompt(String message) {
|
|
||||||
return prompt();
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public void println(String message) {
|
|
||||||
// do nothing
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public void println() {
|
|
||||||
// do nothing
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public void print(String text) {
|
|
||||||
// do nothing
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public void close() throws IOException {
|
|
||||||
// do nothing
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.manager.ConsoleManager#isClosed() */
|
|
||||||
@Override
|
|
||||||
public boolean isClosed() {
|
|
||||||
return i == cmds.length;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Test method for
|
|
||||||
* {@link fr.bigeon.gclc.socket.ConsoleRunnable#ConsoleRunnable(fr.bigeon.gclc.ConsoleApplication, java.lang.Object)}
|
|
||||||
* . */
|
|
||||||
@Test
|
|
||||||
public void testConsoleRunnable() {
|
|
||||||
Object lock = new Object();
|
|
||||||
ConsoleApplication app = new ConsoleTestApplication(
|
|
||||||
new SystemConsoleManager());
|
|
||||||
ConsoleRunnable runnable = new ConsoleRunnable(app, lock);
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Test method for {@link fr.bigeon.gclc.socket.ConsoleRunnable#run()}. */
|
|
||||||
@Test
|
|
||||||
public void testRunFlow() {
|
|
||||||
Object lock = new Object();
|
|
||||||
ConsoleApplication app = new ConsoleTestApplication(
|
|
||||||
new ConsoleManagerTestImplementation(
|
|
||||||
new String[] {"test", ConsoleTestApplication.EXIT})); //$NON-NLS-1$
|
|
||||||
ConsoleRunnable runnable = new ConsoleRunnable(app, lock);
|
|
||||||
|
|
||||||
Thread th = new Thread(runnable);
|
|
||||||
th.start();
|
|
||||||
|
|
||||||
runnable.stop();
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Test method for {@link fr.bigeon.gclc.socket.ConsoleRunnable#stop()}. */
|
|
||||||
@Test
|
|
||||||
public void testStop() {
|
|
||||||
Object lock = new Object();
|
|
||||||
ConsoleApplication app = new ConsoleTestApplication(
|
|
||||||
new ConsoleManagerTestImplementation(
|
|
||||||
new String[] {"test", ConsoleTestApplication.EXIT})); //$NON-NLS-1$
|
|
||||||
ConsoleRunnable runnable = new ConsoleRunnable(app, lock);
|
|
||||||
runnable.stop();
|
|
||||||
Thread th = new Thread(runnable);
|
|
||||||
th.start();
|
|
||||||
runnable.stop();
|
|
||||||
runnable.stop();
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Test method for {@link fr.bigeon.gclc.socket.ConsoleRunnable#stop()}. */
|
|
||||||
@Test
|
|
||||||
public void testRun() {
|
|
||||||
Object lock = new Object();
|
|
||||||
ConsoleApplication app = new ConsoleTestApplication(
|
|
||||||
new ConsoleManagerTestImplementation(
|
|
||||||
new String[] {"test", ConsoleTestApplication.EXIT})); //$NON-NLS-1$
|
|
||||||
ConsoleRunnable runnable = new ConsoleRunnable(app, lock);
|
|
||||||
runnable.run();
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
@@ -1,102 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright E. Bigeon (2014)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* Socket implementation of GCLC.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
package fr.bigeon.gclc.socket;
|
|
||||||
|
|
||||||
import java.io.IOException;
|
|
||||||
|
|
||||||
import fr.bigeon.gclc.ConsoleApplication;
|
|
||||||
import fr.bigeon.gclc.command.Command;
|
|
||||||
import fr.bigeon.gclc.command.ExitCommand;
|
|
||||||
import fr.bigeon.gclc.command.HelpExecutor;
|
|
||||||
import fr.bigeon.gclc.exception.CommandRunException;
|
|
||||||
import fr.bigeon.gclc.exception.InvalidCommandName;
|
|
||||||
import fr.bigeon.gclc.manager.ConsoleManager;
|
|
||||||
|
|
||||||
/** A test-purpose application
|
|
||||||
*
|
|
||||||
* @author Emmanuel Bigeon */
|
|
||||||
public class ConsoleTestApplication extends ConsoleApplication {
|
|
||||||
|
|
||||||
/** Exit command */
|
|
||||||
public static final String EXIT = "exit"; //$NON-NLS-1$
|
|
||||||
|
|
||||||
/** @param manager the manager */
|
|
||||||
@SuppressWarnings("nls")
|
|
||||||
public ConsoleTestApplication(final ConsoleManager manager) {
|
|
||||||
super(manager, "Welcome to the test application. Type help or test.",
|
|
||||||
"See you");
|
|
||||||
try {
|
|
||||||
add(new ExitCommand(EXIT, this));
|
|
||||||
add(new HelpExecutor("help", manager, this.getRoot()));
|
|
||||||
add(new Command("test") {
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public String tip() {
|
|
||||||
return "A test command";
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public void execute(String... args) throws CommandRunException {
|
|
||||||
try {
|
|
||||||
manager.println("Test command ran fine");
|
|
||||||
} catch (IOException e) {
|
|
||||||
throw new CommandRunException("manager closed", e,
|
|
||||||
this);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
});
|
|
||||||
add(new Command("long") {
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public String tip() {
|
|
||||||
return "A long run test command";
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public void execute(String... args) throws CommandRunException {
|
|
||||||
try {
|
|
||||||
Thread.sleep(2000);
|
|
||||||
manager.println("Test command ran fine");
|
|
||||||
} catch (IOException | InterruptedException e) {
|
|
||||||
throw new CommandRunException("manager closed", e,
|
|
||||||
this);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
});
|
|
||||||
} catch (final InvalidCommandName e) {
|
|
||||||
e.printStackTrace();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,138 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright E. Bigeon (2014)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* Socket implementation of GCLC.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
/**
|
|
||||||
* gclc-socket:fr.bigeon.gclc.socket.SocketConsoleApplicationTest.java
|
|
||||||
* Created on: Jun 1, 2016
|
|
||||||
*/
|
|
||||||
package fr.bigeon.gclc.socket;
|
|
||||||
|
|
||||||
import java.io.BufferedReader;
|
|
||||||
import java.io.IOException;
|
|
||||||
import java.io.InputStreamReader;
|
|
||||||
import java.io.PrintWriter;
|
|
||||||
import java.net.Socket;
|
|
||||||
import java.util.Arrays;
|
|
||||||
|
|
||||||
import org.junit.Test;
|
|
||||||
|
|
||||||
import fr.bigeon.smu.StringEncoder;
|
|
||||||
|
|
||||||
/** Test class for {@link SocketConsoleApplicationShell}
|
|
||||||
*
|
|
||||||
* @author Emmanuel Bigeon */
|
|
||||||
@SuppressWarnings({"static-method", "unused", "javadoc", "nls"})
|
|
||||||
public class SocketConsoleApplicationTest {
|
|
||||||
|
|
||||||
private static final StringEncoder ENCODER = new StringEncoder("%",
|
|
||||||
Arrays.asList("\n")); //$NON-NLS-1$
|
|
||||||
|
|
||||||
@Test
|
|
||||||
public void integrationTest() {
|
|
||||||
Thread server = TestServer.startServer(false);
|
|
||||||
try {
|
|
||||||
Thread.sleep(100);
|
|
||||||
} catch (InterruptedException e1) {
|
|
||||||
e1.printStackTrace();
|
|
||||||
}
|
|
||||||
final String hostName = "127.0.0.1";
|
|
||||||
final int portNumber = 3300;
|
|
||||||
|
|
||||||
try (Socket kkSocket = new Socket(hostName, portNumber);
|
|
||||||
PrintWriter out = new PrintWriter(kkSocket.getOutputStream(),
|
|
||||||
true);
|
|
||||||
BufferedReader in = new BufferedReader(
|
|
||||||
new InputStreamReader(kkSocket.getInputStream()));) {
|
|
||||||
|
|
||||||
String fromServer;
|
|
||||||
int i = 0;
|
|
||||||
String[] cmds = {"help", "toto", "test", "close"};
|
|
||||||
while ((fromServer = in.readLine()) != null) {
|
|
||||||
System.out.println("Server: \n" + ENCODER.decode(fromServer));
|
|
||||||
if (fromServer.equals("Bye.")) {
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
|
|
||||||
final String fromUser = cmds[i];
|
|
||||||
if (fromUser != null) {
|
|
||||||
System.out.println("Client: " + fromUser);
|
|
||||||
out.println(fromUser);
|
|
||||||
}
|
|
||||||
i++;
|
|
||||||
}
|
|
||||||
} catch (final IOException e) {
|
|
||||||
e.printStackTrace();
|
|
||||||
}
|
|
||||||
TestServer.closeServer();
|
|
||||||
try {
|
|
||||||
Thread.sleep(100);
|
|
||||||
} catch (InterruptedException e2) {
|
|
||||||
e2.printStackTrace();
|
|
||||||
}
|
|
||||||
server = TestServer.startServer(true);
|
|
||||||
try {
|
|
||||||
Thread.sleep(100);
|
|
||||||
} catch (InterruptedException e1) {
|
|
||||||
e1.printStackTrace();
|
|
||||||
}
|
|
||||||
|
|
||||||
try (Socket kkSocket = new Socket(hostName, portNumber);
|
|
||||||
PrintWriter out = new PrintWriter(kkSocket.getOutputStream(),
|
|
||||||
true);
|
|
||||||
BufferedReader in = new BufferedReader(
|
|
||||||
new InputStreamReader(kkSocket.getInputStream()));) {
|
|
||||||
|
|
||||||
String fromServer;
|
|
||||||
int i = 0;
|
|
||||||
String[] cmds = {"help", "test", "close"};
|
|
||||||
while ((fromServer = in.readLine()) != null) {
|
|
||||||
// System.out.println("Server: \n" + ENCODER.decode(fromServer));
|
|
||||||
if (fromServer.equals("Bye.")) {
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
|
|
||||||
final String fromUser = cmds[i];
|
|
||||||
if (fromUser != null) {
|
|
||||||
// System.out.println("Client: " + fromUser);
|
|
||||||
out.println(fromUser);
|
|
||||||
}
|
|
||||||
i++;
|
|
||||||
}
|
|
||||||
} catch (final IOException e) {
|
|
||||||
e.printStackTrace();
|
|
||||||
}
|
|
||||||
TestServer.closeServer();
|
|
||||||
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,91 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright E. Bigeon (2014)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* Socket implementation of GCLC.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
package fr.bigeon.gclc.socket;
|
|
||||||
|
|
||||||
/** A test server
|
|
||||||
*
|
|
||||||
* @author Emmanuel Bigeon */
|
|
||||||
@SuppressWarnings({"javadoc", "nls"})
|
|
||||||
public class TestServer {
|
|
||||||
|
|
||||||
private static SocketConsoleApplicationShell SHELL;
|
|
||||||
private static Thread server;
|
|
||||||
|
|
||||||
/** @param args no argument */
|
|
||||||
public static void main(String... args) {
|
|
||||||
try {
|
|
||||||
startServer(false).join();
|
|
||||||
} catch (final InterruptedException e) {
|
|
||||||
e.printStackTrace();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
public static Thread getServer() {
|
|
||||||
if (server == null) {
|
|
||||||
server = new Thread(getShell(), "gclcServer");
|
|
||||||
server.start();
|
|
||||||
}
|
|
||||||
return server;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @return */
|
|
||||||
private static SocketConsoleApplicationShell getShell() {
|
|
||||||
if (SHELL == null) {
|
|
||||||
SHELL = new SocketConsoleApplicationShell(3300, "close",
|
|
||||||
ConsoleTestApplication.EXIT);
|
|
||||||
final ConsoleTestApplication app = new ConsoleTestApplication(
|
|
||||||
SHELL.getConsoleManager());
|
|
||||||
SHELL.setApplication(app);
|
|
||||||
}
|
|
||||||
return SHELL;
|
|
||||||
}
|
|
||||||
|
|
||||||
public static Thread startServer(boolean autoClose) {
|
|
||||||
if (SHELL == null) {
|
|
||||||
SHELL = new SocketConsoleApplicationShell(3300, autoClose,
|
|
||||||
ConsoleTestApplication.EXIT);
|
|
||||||
final ConsoleTestApplication app = new ConsoleTestApplication(
|
|
||||||
SHELL.getConsoleManager());
|
|
||||||
SHELL.setApplication(app);
|
|
||||||
server = null;
|
|
||||||
}
|
|
||||||
return getServer();
|
|
||||||
}
|
|
||||||
|
|
||||||
public static void closeServer() {
|
|
||||||
SHELL.stop();
|
|
||||||
SHELL = null;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -0,0 +1,152 @@
|
|||||||
|
package net.bigeon.gclc.socket;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* GCLC Socket
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2016 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.net.Socket;
|
||||||
|
import java.util.Collection;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.ConsoleApplication;
|
||||||
|
import net.bigeon.gclc.command.Command;
|
||||||
|
import net.bigeon.gclc.command.base.ExitCommand;
|
||||||
|
import net.bigeon.gclc.command.base.HelpExecutor;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunException;
|
||||||
|
import net.bigeon.gclc.exception.InvalidCommandName;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleInput;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleOutput;
|
||||||
|
|
||||||
|
/** A test-purpose application
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public class ConsoleTestApplication {
|
||||||
|
|
||||||
|
/** Exit command */
|
||||||
|
public static final String EXIT = "exit"; //$NON-NLS-1$
|
||||||
|
|
||||||
|
/** Create the test application.
|
||||||
|
*
|
||||||
|
* @param output the output
|
||||||
|
* @param input the input
|
||||||
|
* @param manager the manager
|
||||||
|
* @return create the application */
|
||||||
|
@SuppressWarnings("nls")
|
||||||
|
public static ConsoleApplication create(final ConsoleOutput output,
|
||||||
|
final ConsoleInput input, final ConnexionManager<Socket> manager) {
|
||||||
|
try {
|
||||||
|
final ConsoleApplication application = new ConsoleApplication(output, input,
|
||||||
|
"Welcome to the test application. Type help or test.", "See you");
|
||||||
|
application.add(new ExitCommand(EXIT, application) {
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.ExitCommand#beforeExit() */
|
||||||
|
@Override
|
||||||
|
protected void beforeExit() {
|
||||||
|
final Collection<String> coll = manager.getConnected();
|
||||||
|
for (final String string : coll) {
|
||||||
|
manager.disconnect(string);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
application.add(new HelpExecutor("help", application.root));
|
||||||
|
application.add(new Command("test") {
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.ICommand#execute(fr.bigeon.gclc.
|
||||||
|
* manager.ConsoleOutput, fr.bigeon.gclc.manager.ConsoleInput,
|
||||||
|
* java.lang.String[]) */
|
||||||
|
@Override
|
||||||
|
public void execute(final ConsoleOutput out, final ConsoleInput in,
|
||||||
|
final String... args) throws CommandRunException {
|
||||||
|
try {
|
||||||
|
output.println("Test command ran fine");
|
||||||
|
} catch (final IOException e) {
|
||||||
|
throw new CommandRunException("manager closed", e);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public String tip() {
|
||||||
|
return "A test command";
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.Command#usageDetail() */
|
||||||
|
@Override
|
||||||
|
protected String usageDetail() {
|
||||||
|
// TODO Auto-generated method stub
|
||||||
|
// return null;
|
||||||
|
throw new RuntimeException("Not implemented yet");
|
||||||
|
}
|
||||||
|
});
|
||||||
|
application.add(new Command("long") {
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.ICommand#execute(fr.bigeon.gclc.
|
||||||
|
* manager.ConsoleOutput, fr.bigeon.gclc.manager.ConsoleInput,
|
||||||
|
* java.lang.String[]) */
|
||||||
|
@Override
|
||||||
|
public void execute(final ConsoleOutput out, final ConsoleInput in,
|
||||||
|
final String... args) throws CommandRunException {
|
||||||
|
try {
|
||||||
|
Object obj = new Object();
|
||||||
|
synchronized (obj) {
|
||||||
|
obj.wait(2000);
|
||||||
|
}
|
||||||
|
output.println("Test command ran fine");
|
||||||
|
} catch (IOException | InterruptedException e) {
|
||||||
|
throw new CommandRunException("manager closed", e);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public String tip() {
|
||||||
|
return "A long run test command";
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.Command#usageDetail() */
|
||||||
|
@Override
|
||||||
|
protected String usageDetail() {
|
||||||
|
// TODO Auto-generated method stub
|
||||||
|
// return null;
|
||||||
|
throw new RuntimeException("Not implemented yet");
|
||||||
|
}
|
||||||
|
});
|
||||||
|
application.add(new RemoteDisconnectCommand<>("out", manager, true));
|
||||||
|
return application;
|
||||||
|
} catch (final InvalidCommandName e) {
|
||||||
|
e.printStackTrace();
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,218 @@
|
|||||||
|
/**
|
||||||
|
* gclc-socket:net.bigeon.gclc.socket.PluggableConsoleInputTest.java
|
||||||
|
* Created on: Nov 18, 2017
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.socket;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* GCLC Socket
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2016 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import static org.junit.Assert.assertEquals;
|
||||||
|
import static org.junit.Assert.assertFalse;
|
||||||
|
import static org.junit.Assert.assertNotNull;
|
||||||
|
import static org.junit.Assert.assertTrue;
|
||||||
|
import static org.junit.Assert.fail;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.io.PipedInputStream;
|
||||||
|
import java.io.PipedOutputStream;
|
||||||
|
import java.io.PrintStream;
|
||||||
|
import java.util.concurrent.atomic.AtomicReference;
|
||||||
|
|
||||||
|
import org.junit.Test;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* <p>
|
||||||
|
* TODO
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public class PluggableConsoleInputTest {
|
||||||
|
|
||||||
|
/** Test method for
|
||||||
|
* {@link net.bigeon.gclc.socket.PluggableConsoleInput#close()}. */
|
||||||
|
@Test
|
||||||
|
public final void testClose() {
|
||||||
|
final PluggableConsoleInput input = new PluggableConsoleInput();
|
||||||
|
assertFalse("Input should not be initially closed", input.isClosed());
|
||||||
|
input.close();
|
||||||
|
assertTrue("Close should close the input", input.isClosed());
|
||||||
|
|
||||||
|
try {
|
||||||
|
input.prompt();
|
||||||
|
fail("Closed prompt should cause an IO");
|
||||||
|
} catch (final IOException e) {
|
||||||
|
// ok
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
input.prompt(10);
|
||||||
|
fail("Closed prompt should cause an IO");
|
||||||
|
} catch (final IOException e) {
|
||||||
|
// ok
|
||||||
|
}
|
||||||
|
|
||||||
|
final PluggableConsoleInput input2 = new PluggableConsoleInput();
|
||||||
|
|
||||||
|
final Thread th = new Thread(new Runnable() {
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
while (!input2.isPrompting()) {
|
||||||
|
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
Object obj = new Object();
|
||||||
|
synchronized (obj) {
|
||||||
|
obj.wait(100);
|
||||||
|
}
|
||||||
|
} catch (final InterruptedException e) {
|
||||||
|
// TODO Auto-generated catch block
|
||||||
|
e.printStackTrace();
|
||||||
|
}
|
||||||
|
input2.close();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
th.start();
|
||||||
|
try {
|
||||||
|
input.prompt();
|
||||||
|
fail("Closed prompt should cause an IO");
|
||||||
|
} catch (final IOException e) {
|
||||||
|
// ok
|
||||||
|
}
|
||||||
|
final PluggableConsoleInput input3 = new PluggableConsoleInput();
|
||||||
|
|
||||||
|
final Thread th2 = new Thread(new Runnable() {
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
try {
|
||||||
|
Object obj = new Object();
|
||||||
|
synchronized (obj) {
|
||||||
|
obj.wait(200);
|
||||||
|
}
|
||||||
|
} catch (final InterruptedException e) {
|
||||||
|
// TODO Auto-generated catch block
|
||||||
|
e.printStackTrace();
|
||||||
|
}
|
||||||
|
input3.close();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
th2.start();
|
||||||
|
try {
|
||||||
|
input.prompt(2000);
|
||||||
|
fail("Closed prompt should cause an IO");
|
||||||
|
} catch (final IOException e) {
|
||||||
|
// ok
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
public final void testConnect() throws IOException, InterruptedException {
|
||||||
|
final PluggableConsoleInput input = new PluggableConsoleInput();
|
||||||
|
|
||||||
|
input.disconnect();
|
||||||
|
try (final PipedInputStream pis = new PipedInputStream();
|
||||||
|
final PipedOutputStream pos = new PipedOutputStream();
|
||||||
|
final PipedInputStream inner = new PipedInputStream(pos);
|
||||||
|
final PipedOutputStream innerPos = new PipedOutputStream(pis);
|
||||||
|
final PrintStream testIn = new PrintStream(innerPos, true, "UTF8");
|
||||||
|
final PrintStream out = new PrintStream(pos)) {
|
||||||
|
input.connect(pis, out);
|
||||||
|
try {
|
||||||
|
input.connect(pis, out);
|
||||||
|
fail("Should not be able to connect already connected");
|
||||||
|
} catch (final IOException e) {
|
||||||
|
// ok
|
||||||
|
}
|
||||||
|
input.disconnect();
|
||||||
|
|
||||||
|
final Thread th = new Thread(new Runnable() {
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
try {
|
||||||
|
input.prompt("Test", 5000);
|
||||||
|
} catch (final IOException e) {
|
||||||
|
e.printStackTrace();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
th.start();
|
||||||
|
|
||||||
|
Object obj = new Object();
|
||||||
|
synchronized (obj) {
|
||||||
|
while (!input.isPrompting()) {
|
||||||
|
obj.wait(10);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
input.connect(pis, out);
|
||||||
|
testIn.println("tac");
|
||||||
|
|
||||||
|
final AtomicReference<IOException> ref = new AtomicReference<>();
|
||||||
|
final Thread th2 = new Thread(new Runnable() {
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
try {
|
||||||
|
input.prompt("Test", 5000);
|
||||||
|
// fail("Prompt should io");
|
||||||
|
} catch (final IOException e) {
|
||||||
|
// ok
|
||||||
|
ref.set(e);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
th2.start();
|
||||||
|
synchronized (obj) {
|
||||||
|
while (!input.isPrompting()) {
|
||||||
|
obj.wait(10);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
input.close();
|
||||||
|
th2.join();
|
||||||
|
assertNotNull("Prompt should io", ref.get());
|
||||||
|
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Test method for
|
||||||
|
* {@link net.bigeon.gclc.socket.PluggableConsoleInput#getPrompt()}. */
|
||||||
|
@Test
|
||||||
|
public final void testGetPrompt() {
|
||||||
|
final PluggableConsoleInput input = new PluggableConsoleInput();
|
||||||
|
assertEquals("Default prompt invalid", "> ", input.getPrompt().apply());
|
||||||
|
input.setPrompt("test");
|
||||||
|
assertEquals("Prompt setting failed", "test", input.getPrompt().apply());
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,107 @@
|
|||||||
|
/**
|
||||||
|
* gclc-socket:net.bigeon.gclc.socket.RemoteDisconnectCommandTest.java
|
||||||
|
* Created on: Nov 18, 2017
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.socket;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* GCLC Socket
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2016 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import static org.junit.Assert.assertFalse;
|
||||||
|
import static org.junit.Assert.assertTrue;
|
||||||
|
import static org.junit.Assert.fail;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
|
||||||
|
import org.junit.Test;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.exception.CommandRunException;
|
||||||
|
import net.bigeon.gclc.utils.PipedConsoleOutput;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* <p>
|
||||||
|
* TODO
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public class RemoteDisconnectCommandTest {
|
||||||
|
|
||||||
|
/** Test method for
|
||||||
|
* {@link net.bigeon.gclc.socket.RemoteDisconnectCommand#execute(net.bigeon.gclc.manager.ConsoleOutput, net.bigeon.gclc.manager.ConsoleInput, java.lang.String[])}.
|
||||||
|
*
|
||||||
|
* @throws CommandRunException if the command unexpectedly failed.
|
||||||
|
* @throws IOException if the output could not be written to */
|
||||||
|
@Test
|
||||||
|
public final void testExecute() throws CommandRunException, IOException {
|
||||||
|
final DConnexionManager<String> manager = new DConnexionManager<>();
|
||||||
|
final RemoteDisconnectCommand<String> cmd = new RemoteDisconnectCommand<>("quit",
|
||||||
|
manager, true);
|
||||||
|
final RemoteDisconnectCommand<String> cmd2 = new RemoteDisconnectCommand<>("quit",
|
||||||
|
manager, false);
|
||||||
|
manager.addConnexion("test");
|
||||||
|
|
||||||
|
cmd2.execute(null, null);
|
||||||
|
assertFalse("No arguemnt should remova no connections",
|
||||||
|
manager.getConnected().isEmpty());
|
||||||
|
cmd.execute(null, null);
|
||||||
|
assertTrue("No arguemnt should remova all connections",
|
||||||
|
manager.getConnected().isEmpty());
|
||||||
|
|
||||||
|
final String name1 = manager.addConnexion("test");
|
||||||
|
final String name2 = manager.addConnexion("test");
|
||||||
|
|
||||||
|
cmd.execute(null, null, name1);
|
||||||
|
assertFalse("With argument shuld remove specified name",
|
||||||
|
manager.getConnected().contains(name1));
|
||||||
|
assertTrue("With argument shuld remove only specified name",
|
||||||
|
manager.getConnected().contains(name2));
|
||||||
|
|
||||||
|
cmd.execute(null, null, name1);
|
||||||
|
assertTrue("With argument shuld remove only specified name",
|
||||||
|
manager.getConnected().contains(name2));
|
||||||
|
|
||||||
|
try (PipedConsoleOutput out = new PipedConsoleOutput()) {
|
||||||
|
cmd.execute(out, null, name1);
|
||||||
|
assertTrue("With argument shuld remove only specified name",
|
||||||
|
manager.getConnected().contains(name2));
|
||||||
|
|
||||||
|
out.close();
|
||||||
|
try {
|
||||||
|
cmd.execute(out, null, name1);
|
||||||
|
fail("Closed stream should cause error in printing");
|
||||||
|
} catch (final CommandRunException e) {
|
||||||
|
// ok
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
@@ -0,0 +1,160 @@
|
|||||||
|
/**
|
||||||
|
* gclc-socket:net.bigeon.gclc.socket.SocketConsoleApplicationTest.java
|
||||||
|
* Created on: Jun 1, 2016
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.socket;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* GCLC Socket
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2016 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import static org.junit.Assert.assertEquals;
|
||||||
|
|
||||||
|
import java.io.BufferedReader;
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.io.InputStreamReader;
|
||||||
|
import java.io.PrintWriter;
|
||||||
|
import java.net.Socket;
|
||||||
|
import java.util.logging.Logger;
|
||||||
|
|
||||||
|
import org.junit.Test;
|
||||||
|
|
||||||
|
/** Test class for {@link SocketConsoleApplicationShell}
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
@SuppressWarnings({ "static-method", "javadoc", "nls" })
|
||||||
|
public class SocketConsoleApplicationTest {
|
||||||
|
|
||||||
|
private static final Logger LOGGER = Logger
|
||||||
|
.getLogger(SocketConsoleApplicationTest.class.getName());
|
||||||
|
|
||||||
|
/** @param in the input
|
||||||
|
* @return the string
|
||||||
|
* @throws IOException if the input reading failed */
|
||||||
|
private String consumeToPrompt(final String server, final BufferedReader in)
|
||||||
|
throws IOException {
|
||||||
|
String fromServer = server;
|
||||||
|
LOGGER.fine("Server: \n" + fromServer);
|
||||||
|
while (fromServer != null && !fromServer.equals("Bye.")
|
||||||
|
&& !fromServer.equals("> ")) {
|
||||||
|
fromServer = in.readLine();
|
||||||
|
LOGGER.fine("Server: \n" + fromServer);
|
||||||
|
}
|
||||||
|
return fromServer;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
public void testIntegration() throws IOException, InterruptedException {
|
||||||
|
Thread server;
|
||||||
|
server = TestServer.getServer();
|
||||||
|
final String hostName = "127.0.0.1";
|
||||||
|
final int portNumber = 3300;
|
||||||
|
|
||||||
|
try (Socket kkSocket = new Socket(hostName, portNumber);
|
||||||
|
PrintWriter out = new PrintWriter(kkSocket.getOutputStream(), true);
|
||||||
|
BufferedReader in = new BufferedReader(
|
||||||
|
new InputStreamReader(kkSocket.getInputStream()));) {
|
||||||
|
|
||||||
|
String fromServer;
|
||||||
|
int i = -1;
|
||||||
|
final String[] cmds = { "help", "toto", "test", "out" };
|
||||||
|
while ((fromServer = in.readLine()) != null) {
|
||||||
|
i++;
|
||||||
|
fromServer = consumeToPrompt(fromServer, in);
|
||||||
|
if (fromServer == null || fromServer.equals("Bye.")) {
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
|
||||||
|
final String fromUser = cmds[i];
|
||||||
|
if (fromUser != null) {
|
||||||
|
LOGGER.fine("Client: " + fromUser);
|
||||||
|
out.println(fromUser);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
assertEquals("Disconnection command should close connection", 3, i);
|
||||||
|
}
|
||||||
|
|
||||||
|
try (Socket kkSocket = new Socket(hostName, portNumber);
|
||||||
|
PrintWriter out = new PrintWriter(kkSocket.getOutputStream(), true);
|
||||||
|
BufferedReader in = new BufferedReader(
|
||||||
|
new InputStreamReader(kkSocket.getInputStream()));) {
|
||||||
|
|
||||||
|
String fromServer;
|
||||||
|
int i = 0;
|
||||||
|
final String[] cmds = { "help", "toto", "test", ConsoleTestApplication.EXIT };
|
||||||
|
while ((fromServer = in.readLine()) != null) {
|
||||||
|
fromServer = consumeToPrompt(fromServer, in);
|
||||||
|
if (fromServer == null || fromServer.equals("Bye.")) {
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
LOGGER.info("Server: \n" + fromServer);
|
||||||
|
|
||||||
|
final String fromUser = cmds[i];
|
||||||
|
if (fromUser != null) {
|
||||||
|
LOGGER.info("Client: " + fromUser);
|
||||||
|
out.println(fromUser);
|
||||||
|
}
|
||||||
|
i++;
|
||||||
|
}
|
||||||
|
assertEquals("Application exit command should close connection", 4, i);
|
||||||
|
}
|
||||||
|
TestServer.closeServer();
|
||||||
|
server.join();
|
||||||
|
server = TestServer.getServer();
|
||||||
|
|
||||||
|
try (Socket kkSocket = new Socket(hostName, portNumber);
|
||||||
|
PrintWriter out = new PrintWriter(kkSocket.getOutputStream(), true);
|
||||||
|
BufferedReader in = new BufferedReader(
|
||||||
|
new InputStreamReader(kkSocket.getInputStream()));) {
|
||||||
|
|
||||||
|
String fromServer;
|
||||||
|
int i = 0;
|
||||||
|
final String[] cmds = { "help", "toto", "test", ConsoleTestApplication.EXIT };
|
||||||
|
while ((fromServer = in.readLine()) != null) {
|
||||||
|
fromServer = consumeToPrompt(fromServer, in);
|
||||||
|
if (fromServer == null || fromServer.equals("Bye.")) {
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
|
||||||
|
final String fromUser = cmds[i];
|
||||||
|
if (fromUser != null) {
|
||||||
|
LOGGER.fine("Client: " + fromUser);
|
||||||
|
out.println(fromUser);
|
||||||
|
}
|
||||||
|
i++;
|
||||||
|
}
|
||||||
|
assertEquals("Application exit command should close connection", 4, i);
|
||||||
|
}
|
||||||
|
TestServer.closeServer();
|
||||||
|
server.join();
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,95 +1,91 @@
|
|||||||
/*
|
package net.bigeon.gclc.socket;
|
||||||
* Copyright E. Bigeon (2014)
|
|
||||||
*
|
/*-
|
||||||
* emmanuel@bigeon.fr
|
* #%L
|
||||||
*
|
* GCLC Socket
|
||||||
* This software is a computer program whose purpose is to
|
* %%
|
||||||
* Socket implementation of GCLC.
|
* Copyright (C) 2016 - 2018 Bigeon
|
||||||
*
|
* %%
|
||||||
* This software is governed by the CeCILL license under French law and
|
* This software is governed by the CeCILL license under French law and
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
* "http://www.cecill.info".
|
* "http://www.cecill.info".
|
||||||
*
|
*
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
* modify and redistribute granted by the license, users are provided only
|
* modify and redistribute granted by the license, users are provided only
|
||||||
* with a limited warranty and the software's author, the holder of the
|
* with a limited warranty and the software's author, the holder of the
|
||||||
* economic rights, and the successive licensors have only limited
|
* economic rights, and the successive licensors have only limited
|
||||||
* liability.
|
* liability.
|
||||||
*
|
*
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
* software by the user in light of its specific status of free software,
|
* software by the user in light of its specific status of free software,
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
* therefore means that it is reserved for developers and experienced
|
* therefore means that it is reserved for developers and experienced
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
* encouraged to load and test the software's suitability as regards their
|
* encouraged to load and test the software's suitability as regards their
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
* same conditions as regards security.
|
* same conditions as regards security.
|
||||||
*
|
*
|
||||||
* The fact that you are presently reading this means that you have had
|
* The fact that you are presently reading this means that you have had
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
*/
|
* #L%
|
||||||
package fr.bigeon.gclc.socket;
|
*/
|
||||||
|
import java.io.BufferedReader;
|
||||||
import java.io.BufferedReader;
|
import java.io.IOException;
|
||||||
import java.io.IOException;
|
import java.io.InputStreamReader;
|
||||||
import java.io.InputStreamReader;
|
import java.io.PrintWriter;
|
||||||
import java.io.PrintWriter;
|
import java.net.Socket;
|
||||||
import java.net.Socket;
|
import java.util.ArrayList;
|
||||||
import java.util.ArrayList;
|
import java.util.Collection;
|
||||||
import java.util.Collection;
|
|
||||||
|
import net.bigeon.smu.StringEncoder;
|
||||||
import fr.bigeon.smu.StringEncoder;
|
|
||||||
|
/** TODO Describe TestConsoleClient.java
|
||||||
/** TODO Describe TestConsoleClient.java
|
*
|
||||||
* @author Emmanuel Bigeon
|
* @author Emmanuel Bigeon */
|
||||||
*
|
@SuppressWarnings("nls")
|
||||||
*/
|
public class TestConsoleClient {
|
||||||
@SuppressWarnings("nls")
|
@SuppressWarnings("javadoc")
|
||||||
public class TestConsoleClient {
|
private static final Collection<String> TO_ENCODE = new ArrayList<>();
|
||||||
@SuppressWarnings("javadoc")
|
static {
|
||||||
private static final Collection<String> TO_ENCODE = new ArrayList<>();
|
TO_ENCODE.add("\n");
|
||||||
static {
|
}
|
||||||
TO_ENCODE.add("\n");
|
|
||||||
}
|
@SuppressWarnings("javadoc")
|
||||||
|
private static final StringEncoder ENCODER = new StringEncoder("%", TO_ENCODE);
|
||||||
@SuppressWarnings("javadoc")
|
|
||||||
private static final StringEncoder ENCODER = new StringEncoder("%",
|
@SuppressWarnings("javadoc")
|
||||||
TO_ENCODE);
|
public static void main(String[] args) {
|
||||||
|
final String hostName = "127.0.0.1";
|
||||||
@SuppressWarnings("javadoc")
|
final int portNumber = 3300;
|
||||||
public static void main(String[] args) {
|
|
||||||
final String hostName = "127.0.0.1";
|
try (Socket kkSocket = new Socket(hostName, portNumber);
|
||||||
final int portNumber = 3300;
|
PrintWriter out = new PrintWriter(kkSocket.getOutputStream(), true);
|
||||||
|
BufferedReader in = new BufferedReader(
|
||||||
try (Socket kkSocket = new Socket(hostName, portNumber);
|
new InputStreamReader(kkSocket.getInputStream()));) {
|
||||||
PrintWriter out = new PrintWriter(kkSocket.getOutputStream(),
|
|
||||||
true);
|
String fromServer;
|
||||||
BufferedReader in = new BufferedReader(new InputStreamReader(
|
while ((fromServer = in.readLine()) != null) {
|
||||||
kkSocket.getInputStream()));) {
|
System.out.println("Server: \n" + ENCODER.decode(fromServer));
|
||||||
|
if (fromServer.equals("Bye.")) {
|
||||||
String fromServer;
|
break;
|
||||||
while ((fromServer = in.readLine()) != null) {
|
}
|
||||||
System.out.println("Server: \n" + ENCODER.decode(fromServer));
|
|
||||||
if (fromServer.equals("Bye.")) {
|
final BufferedReader stdIn = new BufferedReader(
|
||||||
break;
|
new InputStreamReader(System.in));
|
||||||
}
|
final String fromUser = stdIn.readLine();
|
||||||
|
if (fromUser != null) {
|
||||||
final BufferedReader stdIn = new BufferedReader(
|
System.out.println("Client: " + fromUser);
|
||||||
new InputStreamReader(System.in));
|
out.println(fromUser);
|
||||||
final String fromUser = stdIn.readLine();
|
}
|
||||||
if (fromUser != null) {
|
}
|
||||||
System.out.println("Client: " + fromUser);
|
} catch (final IOException e) {
|
||||||
out.println(fromUser);
|
// TODO Auto-generated catch block
|
||||||
}
|
e.printStackTrace();
|
||||||
}
|
}
|
||||||
} catch (final IOException e) {
|
|
||||||
// TODO Auto-generated catch block
|
}
|
||||||
e.printStackTrace();
|
}
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
}
|
|
||||||
118
gclc-socket/src/test/java/net/bigeon/gclc/socket/TestServer.java
Normal file
118
gclc-socket/src/test/java/net/bigeon/gclc/socket/TestServer.java
Normal file
@@ -0,0 +1,118 @@
|
|||||||
|
package net.bigeon.gclc.socket;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* GCLC Socket
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2016 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.net.InetAddress;
|
||||||
|
import java.net.Socket;
|
||||||
|
import java.net.UnknownHostException;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.ConsoleApplication;
|
||||||
|
|
||||||
|
/** A test server
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
@SuppressWarnings({ "javadoc", "nls" })
|
||||||
|
public class TestServer {
|
||||||
|
|
||||||
|
public static final int PORT = 3300;
|
||||||
|
private static SocketConsoleApplicationShell SHELL;
|
||||||
|
private static ConnexionManager<Socket> manager;
|
||||||
|
|
||||||
|
private static Thread server;
|
||||||
|
private static PluggableConsoleInput input;
|
||||||
|
private static PluggableConsoleOutput output;
|
||||||
|
|
||||||
|
public static synchronized void closeServer() {
|
||||||
|
SHELL.stop();
|
||||||
|
input.close();
|
||||||
|
output.close();
|
||||||
|
SHELL = null;
|
||||||
|
server = null;
|
||||||
|
}
|
||||||
|
|
||||||
|
public static synchronized Thread getServer() throws IOException {
|
||||||
|
if (server == null) {
|
||||||
|
server = new Thread(getShell(), "gclcServer");
|
||||||
|
server.start();
|
||||||
|
}
|
||||||
|
return server;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static SocketConsoleApplicationShell getShell() throws UnknownHostException {
|
||||||
|
if (SHELL == null) {
|
||||||
|
input = new PluggableConsoleInput();
|
||||||
|
input.setPrompt("> \n");
|
||||||
|
output = new PluggableConsoleOutput();
|
||||||
|
manager = new DConnexionManager<>();
|
||||||
|
SHELL = new SocketConsoleApplicationShell(PORT,
|
||||||
|
InetAddress.getByName("127.0.0.1"));
|
||||||
|
final ConsoleApplication app = ConsoleTestApplication.create(output, input,
|
||||||
|
manager);
|
||||||
|
SHELL.setInterface(new SocketConsoleInterface(input, output));
|
||||||
|
SHELL.setConnexionManager(manager);
|
||||||
|
SHELL.setApplication(app);
|
||||||
|
final Thread th = new Thread(new Runnable() {
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
app.start();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
th.start();
|
||||||
|
try {
|
||||||
|
final Object waiting = new Object();
|
||||||
|
synchronized (waiting) {
|
||||||
|
while (!input.isPrompting()) {
|
||||||
|
waiting.wait(50);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (final InterruptedException e) {
|
||||||
|
Thread.currentThread().interrupt();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return SHELL;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** @param args no argument
|
||||||
|
* @throws IOException if the server starting failed */
|
||||||
|
public static void main(final String... args) throws IOException {
|
||||||
|
try {
|
||||||
|
getServer().join();
|
||||||
|
} catch (final InterruptedException e) {
|
||||||
|
e.printStackTrace();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
517
gclc-swt/LICENSE.txt
Normal file
517
gclc-swt/LICENSE.txt
Normal file
@@ -0,0 +1,517 @@
|
|||||||
|
CeCILL FREE SOFTWARE LICENSE AGREEMENT
|
||||||
|
|
||||||
|
Version 2.1 dated 2013-06-21
|
||||||
|
|
||||||
|
|
||||||
|
Notice
|
||||||
|
|
||||||
|
This Agreement is a Free Software license agreement that is the result
|
||||||
|
of discussions between its authors in order to ensure compliance with
|
||||||
|
the two main principles guiding its drafting:
|
||||||
|
|
||||||
|
* firstly, compliance with the principles governing the distribution
|
||||||
|
of Free Software: access to source code, broad rights granted to users,
|
||||||
|
* secondly, the election of a governing law, French law, with which it
|
||||||
|
is conformant, both as regards the law of torts and intellectual
|
||||||
|
property law, and the protection that it offers to both authors and
|
||||||
|
holders of the economic rights over software.
|
||||||
|
|
||||||
|
The authors of the CeCILL (for Ce[a] C[nrs] I[nria] L[ogiciel] L[ibre])
|
||||||
|
license are:
|
||||||
|
|
||||||
|
Commissariat à l'énergie atomique et aux énergies alternatives - CEA, a
|
||||||
|
public scientific, technical and industrial research establishment,
|
||||||
|
having its principal place of business at 25 rue Leblanc, immeuble Le
|
||||||
|
Ponant D, 75015 Paris, France.
|
||||||
|
|
||||||
|
Centre National de la Recherche Scientifique - CNRS, a public scientific
|
||||||
|
and technological establishment, having its principal place of business
|
||||||
|
at 3 rue Michel-Ange, 75794 Paris cedex 16, France.
|
||||||
|
|
||||||
|
Institut National de Recherche en Informatique et en Automatique -
|
||||||
|
Inria, a public scientific and technological establishment, having its
|
||||||
|
principal place of business at Domaine de Voluceau, Rocquencourt, BP
|
||||||
|
105, 78153 Le Chesnay cedex, France.
|
||||||
|
|
||||||
|
|
||||||
|
Preamble
|
||||||
|
|
||||||
|
The purpose of this Free Software license agreement is to grant users
|
||||||
|
the right to modify and redistribute the software governed by this
|
||||||
|
license within the framework of an open source distribution model.
|
||||||
|
|
||||||
|
The exercising of this right is conditional upon certain obligations for
|
||||||
|
users so as to preserve this status for all subsequent redistributions.
|
||||||
|
|
||||||
|
In consideration of access to the source code and the rights to copy,
|
||||||
|
modify and redistribute granted by the license, users are provided only
|
||||||
|
with a limited warranty and the software's author, the holder of the
|
||||||
|
economic rights, and the successive licensors only have limited liability.
|
||||||
|
|
||||||
|
In this respect, the risks associated with loading, using, modifying
|
||||||
|
and/or developing or reproducing the software by the user are brought to
|
||||||
|
the user's attention, given its Free Software status, which may make it
|
||||||
|
complicated to use, with the result that its use is reserved for
|
||||||
|
developers and experienced professionals having in-depth computer
|
||||||
|
knowledge. Users are therefore encouraged to load and test the
|
||||||
|
suitability of the software as regards their requirements in conditions
|
||||||
|
enabling the security of their systems and/or data to be ensured and,
|
||||||
|
more generally, to use and operate it in the same conditions of
|
||||||
|
security. This Agreement may be freely reproduced and published,
|
||||||
|
provided it is not altered, and that no provisions are either added or
|
||||||
|
removed herefrom.
|
||||||
|
|
||||||
|
This Agreement may apply to any or all software for which the holder of
|
||||||
|
the economic rights decides to submit the use thereof to its provisions.
|
||||||
|
|
||||||
|
Frequently asked questions can be found on the official website of the
|
||||||
|
CeCILL licenses family (http://www.cecill.info/index.en.html) for any
|
||||||
|
necessary clarification.
|
||||||
|
|
||||||
|
|
||||||
|
Article 1 - DEFINITIONS
|
||||||
|
|
||||||
|
For the purpose of this Agreement, when the following expressions
|
||||||
|
commence with a capital letter, they shall have the following meaning:
|
||||||
|
|
||||||
|
Agreement: means this license agreement, and its possible subsequent
|
||||||
|
versions and annexes.
|
||||||
|
|
||||||
|
Software: means the software in its Object Code and/or Source Code form
|
||||||
|
and, where applicable, its documentation, "as is" when the Licensee
|
||||||
|
accepts the Agreement.
|
||||||
|
|
||||||
|
Initial Software: means the Software in its Source Code and possibly its
|
||||||
|
Object Code form and, where applicable, its documentation, "as is" when
|
||||||
|
it is first distributed under the terms and conditions of the Agreement.
|
||||||
|
|
||||||
|
Modified Software: means the Software modified by at least one
|
||||||
|
Contribution.
|
||||||
|
|
||||||
|
Source Code: means all the Software's instructions and program lines to
|
||||||
|
which access is required so as to modify the Software.
|
||||||
|
|
||||||
|
Object Code: means the binary files originating from the compilation of
|
||||||
|
the Source Code.
|
||||||
|
|
||||||
|
Holder: means the holder(s) of the economic rights over the Initial
|
||||||
|
Software.
|
||||||
|
|
||||||
|
Licensee: means the Software user(s) having accepted the Agreement.
|
||||||
|
|
||||||
|
Contributor: means a Licensee having made at least one Contribution.
|
||||||
|
|
||||||
|
Licensor: means the Holder, or any other individual or legal entity, who
|
||||||
|
distributes the Software under the Agreement.
|
||||||
|
|
||||||
|
Contribution: means any or all modifications, corrections, translations,
|
||||||
|
adaptations and/or new functions integrated into the Software by any or
|
||||||
|
all Contributors, as well as any or all Internal Modules.
|
||||||
|
|
||||||
|
Module: means a set of sources files including their documentation that
|
||||||
|
enables supplementary functions or services in addition to those offered
|
||||||
|
by the Software.
|
||||||
|
|
||||||
|
External Module: means any or all Modules, not derived from the
|
||||||
|
Software, so that this Module and the Software run in separate address
|
||||||
|
spaces, with one calling the other when they are run.
|
||||||
|
|
||||||
|
Internal Module: means any or all Module, connected to the Software so
|
||||||
|
that they both execute in the same address space.
|
||||||
|
|
||||||
|
GNU GPL: means the GNU General Public License version 2 or any
|
||||||
|
subsequent version, as published by the Free Software Foundation Inc.
|
||||||
|
|
||||||
|
GNU Affero GPL: means the GNU Affero General Public License version 3 or
|
||||||
|
any subsequent version, as published by the Free Software Foundation Inc.
|
||||||
|
|
||||||
|
EUPL: means the European Union Public License version 1.1 or any
|
||||||
|
subsequent version, as published by the European Commission.
|
||||||
|
|
||||||
|
Parties: mean both the Licensee and the Licensor.
|
||||||
|
|
||||||
|
These expressions may be used both in singular and plural form.
|
||||||
|
|
||||||
|
|
||||||
|
Article 2 - PURPOSE
|
||||||
|
|
||||||
|
The purpose of the Agreement is the grant by the Licensor to the
|
||||||
|
Licensee of a non-exclusive, transferable and worldwide license for the
|
||||||
|
Software as set forth in Article 5 <#scope> hereinafter for the whole
|
||||||
|
term of the protection granted by the rights over said Software.
|
||||||
|
|
||||||
|
|
||||||
|
Article 3 - ACCEPTANCE
|
||||||
|
|
||||||
|
3.1 The Licensee shall be deemed as having accepted the terms and
|
||||||
|
conditions of this Agreement upon the occurrence of the first of the
|
||||||
|
following events:
|
||||||
|
|
||||||
|
* (i) loading the Software by any or all means, notably, by
|
||||||
|
downloading from a remote server, or by loading from a physical medium;
|
||||||
|
* (ii) the first time the Licensee exercises any of the rights granted
|
||||||
|
hereunder.
|
||||||
|
|
||||||
|
3.2 One copy of the Agreement, containing a notice relating to the
|
||||||
|
characteristics of the Software, to the limited warranty, and to the
|
||||||
|
fact that its use is restricted to experienced users has been provided
|
||||||
|
to the Licensee prior to its acceptance as set forth in Article 3.1
|
||||||
|
<#accepting> hereinabove, and the Licensee hereby acknowledges that it
|
||||||
|
has read and understood it.
|
||||||
|
|
||||||
|
|
||||||
|
Article 4 - EFFECTIVE DATE AND TERM
|
||||||
|
|
||||||
|
|
||||||
|
4.1 EFFECTIVE DATE
|
||||||
|
|
||||||
|
The Agreement shall become effective on the date when it is accepted by
|
||||||
|
the Licensee as set forth in Article 3.1 <#accepting>.
|
||||||
|
|
||||||
|
|
||||||
|
4.2 TERM
|
||||||
|
|
||||||
|
The Agreement shall remain in force for the entire legal term of
|
||||||
|
protection of the economic rights over the Software.
|
||||||
|
|
||||||
|
|
||||||
|
Article 5 - SCOPE OF RIGHTS GRANTED
|
||||||
|
|
||||||
|
The Licensor hereby grants to the Licensee, who accepts, the following
|
||||||
|
rights over the Software for any or all use, and for the term of the
|
||||||
|
Agreement, on the basis of the terms and conditions set forth hereinafter.
|
||||||
|
|
||||||
|
Besides, if the Licensor owns or comes to own one or more patents
|
||||||
|
protecting all or part of the functions of the Software or of its
|
||||||
|
components, the Licensor undertakes not to enforce the rights granted by
|
||||||
|
these patents against successive Licensees using, exploiting or
|
||||||
|
modifying the Software. If these patents are transferred, the Licensor
|
||||||
|
undertakes to have the transferees subscribe to the obligations set
|
||||||
|
forth in this paragraph.
|
||||||
|
|
||||||
|
|
||||||
|
5.1 RIGHT OF USE
|
||||||
|
|
||||||
|
The Licensee is authorized to use the Software, without any limitation
|
||||||
|
as to its fields of application, with it being hereinafter specified
|
||||||
|
that this comprises:
|
||||||
|
|
||||||
|
1. permanent or temporary reproduction of all or part of the Software
|
||||||
|
by any or all means and in any or all form.
|
||||||
|
|
||||||
|
2. loading, displaying, running, or storing the Software on any or all
|
||||||
|
medium.
|
||||||
|
|
||||||
|
3. entitlement to observe, study or test its operation so as to
|
||||||
|
determine the ideas and principles behind any or all constituent
|
||||||
|
elements of said Software. This shall apply when the Licensee
|
||||||
|
carries out any or all loading, displaying, running, transmission or
|
||||||
|
storage operation as regards the Software, that it is entitled to
|
||||||
|
carry out hereunder.
|
||||||
|
|
||||||
|
|
||||||
|
5.2 ENTITLEMENT TO MAKE CONTRIBUTIONS
|
||||||
|
|
||||||
|
The right to make Contributions includes the right to translate, adapt,
|
||||||
|
arrange, or make any or all modifications to the Software, and the right
|
||||||
|
to reproduce the resulting software.
|
||||||
|
|
||||||
|
The Licensee is authorized to make any or all Contributions to the
|
||||||
|
Software provided that it includes an explicit notice that it is the
|
||||||
|
author of said Contribution and indicates the date of the creation thereof.
|
||||||
|
|
||||||
|
|
||||||
|
5.3 RIGHT OF DISTRIBUTION
|
||||||
|
|
||||||
|
In particular, the right of distribution includes the right to publish,
|
||||||
|
transmit and communicate the Software to the general public on any or
|
||||||
|
all medium, and by any or all means, and the right to market, either in
|
||||||
|
consideration of a fee, or free of charge, one or more copies of the
|
||||||
|
Software by any means.
|
||||||
|
|
||||||
|
The Licensee is further authorized to distribute copies of the modified
|
||||||
|
or unmodified Software to third parties according to the terms and
|
||||||
|
conditions set forth hereinafter.
|
||||||
|
|
||||||
|
|
||||||
|
5.3.1 DISTRIBUTION OF SOFTWARE WITHOUT MODIFICATION
|
||||||
|
|
||||||
|
The Licensee is authorized to distribute true copies of the Software in
|
||||||
|
Source Code or Object Code form, provided that said distribution
|
||||||
|
complies with all the provisions of the Agreement and is accompanied by:
|
||||||
|
|
||||||
|
1. a copy of the Agreement,
|
||||||
|
|
||||||
|
2. a notice relating to the limitation of both the Licensor's warranty
|
||||||
|
and liability as set forth in Articles 8 and 9,
|
||||||
|
|
||||||
|
and that, in the event that only the Object Code of the Software is
|
||||||
|
redistributed, the Licensee allows effective access to the full Source
|
||||||
|
Code of the Software for a period of at least three years from the
|
||||||
|
distribution of the Software, it being understood that the additional
|
||||||
|
acquisition cost of the Source Code shall not exceed the cost of the
|
||||||
|
data transfer.
|
||||||
|
|
||||||
|
|
||||||
|
5.3.2 DISTRIBUTION OF MODIFIED SOFTWARE
|
||||||
|
|
||||||
|
When the Licensee makes a Contribution to the Software, the terms and
|
||||||
|
conditions for the distribution of the resulting Modified Software
|
||||||
|
become subject to all the provisions of this Agreement.
|
||||||
|
|
||||||
|
The Licensee is authorized to distribute the Modified Software, in
|
||||||
|
source code or object code form, provided that said distribution
|
||||||
|
complies with all the provisions of the Agreement and is accompanied by:
|
||||||
|
|
||||||
|
1. a copy of the Agreement,
|
||||||
|
|
||||||
|
2. a notice relating to the limitation of both the Licensor's warranty
|
||||||
|
and liability as set forth in Articles 8 and 9,
|
||||||
|
|
||||||
|
and, in the event that only the object code of the Modified Software is
|
||||||
|
redistributed,
|
||||||
|
|
||||||
|
3. a note stating the conditions of effective access to the full source
|
||||||
|
code of the Modified Software for a period of at least three years
|
||||||
|
from the distribution of the Modified Software, it being understood
|
||||||
|
that the additional acquisition cost of the source code shall not
|
||||||
|
exceed the cost of the data transfer.
|
||||||
|
|
||||||
|
|
||||||
|
5.3.3 DISTRIBUTION OF EXTERNAL MODULES
|
||||||
|
|
||||||
|
When the Licensee has developed an External Module, the terms and
|
||||||
|
conditions of this Agreement do not apply to said External Module, that
|
||||||
|
may be distributed under a separate license agreement.
|
||||||
|
|
||||||
|
|
||||||
|
5.3.4 COMPATIBILITY WITH OTHER LICENSES
|
||||||
|
|
||||||
|
The Licensee can include a code that is subject to the provisions of one
|
||||||
|
of the versions of the GNU GPL, GNU Affero GPL and/or EUPL in the
|
||||||
|
Modified or unmodified Software, and distribute that entire code under
|
||||||
|
the terms of the same version of the GNU GPL, GNU Affero GPL and/or EUPL.
|
||||||
|
|
||||||
|
The Licensee can include the Modified or unmodified Software in a code
|
||||||
|
that is subject to the provisions of one of the versions of the GNU GPL,
|
||||||
|
GNU Affero GPL and/or EUPL and distribute that entire code under the
|
||||||
|
terms of the same version of the GNU GPL, GNU Affero GPL and/or EUPL.
|
||||||
|
|
||||||
|
|
||||||
|
Article 6 - INTELLECTUAL PROPERTY
|
||||||
|
|
||||||
|
|
||||||
|
6.1 OVER THE INITIAL SOFTWARE
|
||||||
|
|
||||||
|
The Holder owns the economic rights over the Initial Software. Any or
|
||||||
|
all use of the Initial Software is subject to compliance with the terms
|
||||||
|
and conditions under which the Holder has elected to distribute its work
|
||||||
|
and no one shall be entitled to modify the terms and conditions for the
|
||||||
|
distribution of said Initial Software.
|
||||||
|
|
||||||
|
The Holder undertakes that the Initial Software will remain ruled at
|
||||||
|
least by this Agreement, for the duration set forth in Article 4.2 <#term>.
|
||||||
|
|
||||||
|
|
||||||
|
6.2 OVER THE CONTRIBUTIONS
|
||||||
|
|
||||||
|
The Licensee who develops a Contribution is the owner of the
|
||||||
|
intellectual property rights over this Contribution as defined by
|
||||||
|
applicable law.
|
||||||
|
|
||||||
|
|
||||||
|
6.3 OVER THE EXTERNAL MODULES
|
||||||
|
|
||||||
|
The Licensee who develops an External Module is the owner of the
|
||||||
|
intellectual property rights over this External Module as defined by
|
||||||
|
applicable law and is free to choose the type of agreement that shall
|
||||||
|
govern its distribution.
|
||||||
|
|
||||||
|
|
||||||
|
6.4 JOINT PROVISIONS
|
||||||
|
|
||||||
|
The Licensee expressly undertakes:
|
||||||
|
|
||||||
|
1. not to remove, or modify, in any manner, the intellectual property
|
||||||
|
notices attached to the Software;
|
||||||
|
|
||||||
|
2. to reproduce said notices, in an identical manner, in the copies of
|
||||||
|
the Software modified or not.
|
||||||
|
|
||||||
|
The Licensee undertakes not to directly or indirectly infringe the
|
||||||
|
intellectual property rights on the Software of the Holder and/or
|
||||||
|
Contributors, and to take, where applicable, vis-à-vis its staff, any
|
||||||
|
and all measures required to ensure respect of said intellectual
|
||||||
|
property rights of the Holder and/or Contributors.
|
||||||
|
|
||||||
|
|
||||||
|
Article 7 - RELATED SERVICES
|
||||||
|
|
||||||
|
7.1 Under no circumstances shall the Agreement oblige the Licensor to
|
||||||
|
provide technical assistance or maintenance services for the Software.
|
||||||
|
|
||||||
|
However, the Licensor is entitled to offer this type of services. The
|
||||||
|
terms and conditions of such technical assistance, and/or such
|
||||||
|
maintenance, shall be set forth in a separate instrument. Only the
|
||||||
|
Licensor offering said maintenance and/or technical assistance services
|
||||||
|
shall incur liability therefor.
|
||||||
|
|
||||||
|
7.2 Similarly, any Licensor is entitled to offer to its licensees, under
|
||||||
|
its sole responsibility, a warranty, that shall only be binding upon
|
||||||
|
itself, for the redistribution of the Software and/or the Modified
|
||||||
|
Software, under terms and conditions that it is free to decide. Said
|
||||||
|
warranty, and the financial terms and conditions of its application,
|
||||||
|
shall be subject of a separate instrument executed between the Licensor
|
||||||
|
and the Licensee.
|
||||||
|
|
||||||
|
|
||||||
|
Article 8 - LIABILITY
|
||||||
|
|
||||||
|
8.1 Subject to the provisions of Article 8.2, the Licensee shall be
|
||||||
|
entitled to claim compensation for any direct loss it may have suffered
|
||||||
|
from the Software as a result of a fault on the part of the relevant
|
||||||
|
Licensor, subject to providing evidence thereof.
|
||||||
|
|
||||||
|
8.2 The Licensor's liability is limited to the commitments made under
|
||||||
|
this Agreement and shall not be incurred as a result of in particular:
|
||||||
|
(i) loss due the Licensee's total or partial failure to fulfill its
|
||||||
|
obligations, (ii) direct or consequential loss that is suffered by the
|
||||||
|
Licensee due to the use or performance of the Software, and (iii) more
|
||||||
|
generally, any consequential loss. In particular the Parties expressly
|
||||||
|
agree that any or all pecuniary or business loss (i.e. loss of data,
|
||||||
|
loss of profits, operating loss, loss of customers or orders,
|
||||||
|
opportunity cost, any disturbance to business activities) or any or all
|
||||||
|
legal proceedings instituted against the Licensee by a third party,
|
||||||
|
shall constitute consequential loss and shall not provide entitlement to
|
||||||
|
any or all compensation from the Licensor.
|
||||||
|
|
||||||
|
|
||||||
|
Article 9 - WARRANTY
|
||||||
|
|
||||||
|
9.1 The Licensee acknowledges that the scientific and technical
|
||||||
|
state-of-the-art when the Software was distributed did not enable all
|
||||||
|
possible uses to be tested and verified, nor for the presence of
|
||||||
|
possible defects to be detected. In this respect, the Licensee's
|
||||||
|
attention has been drawn to the risks associated with loading, using,
|
||||||
|
modifying and/or developing and reproducing the Software which are
|
||||||
|
reserved for experienced users.
|
||||||
|
|
||||||
|
The Licensee shall be responsible for verifying, by any or all means,
|
||||||
|
the suitability of the product for its requirements, its good working
|
||||||
|
order, and for ensuring that it shall not cause damage to either persons
|
||||||
|
or properties.
|
||||||
|
|
||||||
|
9.2 The Licensor hereby represents, in good faith, that it is entitled
|
||||||
|
to grant all the rights over the Software (including in particular the
|
||||||
|
rights set forth in Article 5 <#scope>).
|
||||||
|
|
||||||
|
9.3 The Licensee acknowledges that the Software is supplied "as is" by
|
||||||
|
the Licensor without any other express or tacit warranty, other than
|
||||||
|
that provided for in Article 9.2 <#good-faith> and, in particular,
|
||||||
|
without any warranty as to its commercial value, its secured, safe,
|
||||||
|
innovative or relevant nature.
|
||||||
|
|
||||||
|
Specifically, the Licensor does not warrant that the Software is free
|
||||||
|
from any error, that it will operate without interruption, that it will
|
||||||
|
be compatible with the Licensee's own equipment and software
|
||||||
|
configuration, nor that it will meet the Licensee's requirements.
|
||||||
|
|
||||||
|
9.4 The Licensor does not either expressly or tacitly warrant that the
|
||||||
|
Software does not infringe any third party intellectual property right
|
||||||
|
relating to a patent, software or any other property right. Therefore,
|
||||||
|
the Licensor disclaims any and all liability towards the Licensee
|
||||||
|
arising out of any or all proceedings for infringement that may be
|
||||||
|
instituted in respect of the use, modification and redistribution of the
|
||||||
|
Software. Nevertheless, should such proceedings be instituted against
|
||||||
|
the Licensee, the Licensor shall provide it with technical and legal
|
||||||
|
expertise for its defense. Such technical and legal expertise shall be
|
||||||
|
decided on a case-by-case basis between the relevant Licensor and the
|
||||||
|
Licensee pursuant to a memorandum of understanding. The Licensor
|
||||||
|
disclaims any and all liability as regards the Licensee's use of the
|
||||||
|
name of the Software. No warranty is given as regards the existence of
|
||||||
|
prior rights over the name of the Software or as regards the existence
|
||||||
|
of a trademark.
|
||||||
|
|
||||||
|
|
||||||
|
Article 10 - TERMINATION
|
||||||
|
|
||||||
|
10.1 In the event of a breach by the Licensee of its obligations
|
||||||
|
hereunder, the Licensor may automatically terminate this Agreement
|
||||||
|
thirty (30) days after notice has been sent to the Licensee and has
|
||||||
|
remained ineffective.
|
||||||
|
|
||||||
|
10.2 A Licensee whose Agreement is terminated shall no longer be
|
||||||
|
authorized to use, modify or distribute the Software. However, any
|
||||||
|
licenses that it may have granted prior to termination of the Agreement
|
||||||
|
shall remain valid subject to their having been granted in compliance
|
||||||
|
with the terms and conditions hereof.
|
||||||
|
|
||||||
|
|
||||||
|
Article 11 - MISCELLANEOUS
|
||||||
|
|
||||||
|
|
||||||
|
11.1 EXCUSABLE EVENTS
|
||||||
|
|
||||||
|
Neither Party shall be liable for any or all delay, or failure to
|
||||||
|
perform the Agreement, that may be attributable to an event of force
|
||||||
|
majeure, an act of God or an outside cause, such as defective
|
||||||
|
functioning or interruptions of the electricity or telecommunications
|
||||||
|
networks, network paralysis following a virus attack, intervention by
|
||||||
|
government authorities, natural disasters, water damage, earthquakes,
|
||||||
|
fire, explosions, strikes and labor unrest, war, etc.
|
||||||
|
|
||||||
|
11.2 Any failure by either Party, on one or more occasions, to invoke
|
||||||
|
one or more of the provisions hereof, shall under no circumstances be
|
||||||
|
interpreted as being a waiver by the interested Party of its right to
|
||||||
|
invoke said provision(s) subsequently.
|
||||||
|
|
||||||
|
11.3 The Agreement cancels and replaces any or all previous agreements,
|
||||||
|
whether written or oral, between the Parties and having the same
|
||||||
|
purpose, and constitutes the entirety of the agreement between said
|
||||||
|
Parties concerning said purpose. No supplement or modification to the
|
||||||
|
terms and conditions hereof shall be effective as between the Parties
|
||||||
|
unless it is made in writing and signed by their duly authorized
|
||||||
|
representatives.
|
||||||
|
|
||||||
|
11.4 In the event that one or more of the provisions hereof were to
|
||||||
|
conflict with a current or future applicable act or legislative text,
|
||||||
|
said act or legislative text shall prevail, and the Parties shall make
|
||||||
|
the necessary amendments so as to comply with said act or legislative
|
||||||
|
text. All other provisions shall remain effective. Similarly, invalidity
|
||||||
|
of a provision of the Agreement, for any reason whatsoever, shall not
|
||||||
|
cause the Agreement as a whole to be invalid.
|
||||||
|
|
||||||
|
|
||||||
|
11.5 LANGUAGE
|
||||||
|
|
||||||
|
The Agreement is drafted in both French and English and both versions
|
||||||
|
are deemed authentic.
|
||||||
|
|
||||||
|
|
||||||
|
Article 12 - NEW VERSIONS OF THE AGREEMENT
|
||||||
|
|
||||||
|
12.1 Any person is authorized to duplicate and distribute copies of this
|
||||||
|
Agreement.
|
||||||
|
|
||||||
|
12.2 So as to ensure coherence, the wording of this Agreement is
|
||||||
|
protected and may only be modified by the authors of the License, who
|
||||||
|
reserve the right to periodically publish updates or new versions of the
|
||||||
|
Agreement, each with a separate number. These subsequent versions may
|
||||||
|
address new issues encountered by Free Software.
|
||||||
|
|
||||||
|
12.3 Any Software distributed under a given version of the Agreement may
|
||||||
|
only be subsequently distributed under the same version of the Agreement
|
||||||
|
or a subsequent version, subject to the provisions of Article 5.3.4
|
||||||
|
<#compatibility>.
|
||||||
|
|
||||||
|
|
||||||
|
Article 13 - GOVERNING LAW AND JURISDICTION
|
||||||
|
|
||||||
|
13.1 The Agreement is governed by French law. The Parties agree to
|
||||||
|
endeavor to seek an amicable solution to any disagreements or disputes
|
||||||
|
that may arise during the performance of the Agreement.
|
||||||
|
|
||||||
|
13.2 Failing an amicable solution within two (2) months as from their
|
||||||
|
occurrence, and unless emergency proceedings are necessary, the
|
||||||
|
disagreements or disputes shall be referred to the Paris Courts having
|
||||||
|
jurisdiction, by the more diligent Party.
|
||||||
177
gclc-swt/pom.xml
177
gclc-swt/pom.xml
@@ -1,103 +1,74 @@
|
|||||||
|
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
|
||||||
<!-- Copyright E. Bigeon (2015) -->
|
<modelVersion>4.0.0</modelVersion>
|
||||||
<!-- -->
|
<parent>
|
||||||
<!-- emmanuel@bigeon.fr -->
|
<groupId>net.bigeon.config</groupId>
|
||||||
<!-- -->
|
<artifactId>swt-config</artifactId>
|
||||||
<!-- This software is a computer program whose purpose is to -->
|
<version>1.8.11</version>
|
||||||
<!-- provide a swt window for console applications. -->
|
</parent>
|
||||||
<!-- -->
|
<groupId>net.bigeon.gclc</groupId>
|
||||||
<!-- This software is governed by the CeCILL license under French law and -->
|
<artifactId>swt</artifactId>
|
||||||
<!-- abiding by the rules of distribution of free software. You can use, -->
|
<version>1.1.6</version>
|
||||||
<!-- modify and/or redistribute the software under the terms of the CeCILL -->
|
<packaging>jar</packaging>
|
||||||
<!-- license as circulated by CEA, CNRS and INRIA at the following URL -->
|
<name>GCLC swt</name>
|
||||||
<!-- "http://www.cecill.info". -->
|
<description>A swt window for console applications</description>
|
||||||
<!-- -->
|
<url>https://bigeon.net/projects/gclc.html</url>
|
||||||
<!-- As a counterpart to the access to the source code and rights to copy, -->
|
<inceptionYear>2015</inceptionYear>
|
||||||
<!-- modify and redistribute granted by the license, users are provided only -->
|
<organization>
|
||||||
<!-- with a limited warranty and the software's author, the holder of the -->
|
<name>Bigeon</name>
|
||||||
<!-- economic rights, and the successive licensors have only limited -->
|
<url>https://bigeon.net/</url>
|
||||||
<!-- liability. -->
|
</organization>
|
||||||
<!-- -->
|
<licenses>
|
||||||
<!-- In this respect, the user's attention is drawn to the risks associated -->
|
<license>
|
||||||
<!-- with loading, using, modifying and/or developing or reproducing the -->
|
<distribution>manual</distribution>
|
||||||
<!-- software by the user in light of its specific status of free software, -->
|
<name>CeCILL 2.1</name>
|
||||||
<!-- that may mean that it is complicated to manipulate, and that also -->
|
<url>https://cecill.info/licences/Licence_CeCILL_V2.1-en.html</url>
|
||||||
<!-- therefore means that it is reserved for developers and experienced -->
|
</license>
|
||||||
<!-- professionals having in-depth computer knowledge. Users are therefore -->
|
</licenses>
|
||||||
<!-- encouraged to load and test the software's suitability as regards their -->
|
<developers>
|
||||||
<!-- requirements in conditions enabling the security of their systems and/or -->
|
<developer>
|
||||||
<!-- data to be ensured and, more generally, to use and operate it in the -->
|
<email>emmanuel@bigeon.fr</email>
|
||||||
<!-- same conditions as regards security. -->
|
<name>Emmanuel Bigeon</name>
|
||||||
<!-- -->
|
<url>bigeon.net</url>
|
||||||
<!-- The fact that you are presently reading this means that you have had -->
|
<roles>
|
||||||
<!-- knowledge of the CeCILL license and that you accept its terms. -->
|
<role>PM</role>
|
||||||
|
</roles>
|
||||||
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
</developer>
|
||||||
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"
|
</developers>
|
||||||
>
|
<scm>
|
||||||
<modelVersion>4.0.0</modelVersion>
|
<developerConnection>scm:git:gogs@git.code.bigeon.net:emmanuel/gclc.git</developerConnection>
|
||||||
<artifactId>gclc-swt</artifactId>
|
<tag>swt-1.1.6</tag>
|
||||||
<version>1.0.5-SNAPSHOT</version>
|
</scm>
|
||||||
<packaging>jar</packaging>
|
<properties>
|
||||||
<url>http://www.bigeon.fr/emmanuel</url>
|
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
|
||||||
<properties>
|
<copyright.email>emmanuel@bigeon.fr</copyright.email>
|
||||||
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
|
<license.licenseName>cecill_2.1</license.licenseName>
|
||||||
<project.scm.id>git.bigeon.net</project.scm.id>
|
</properties>
|
||||||
</properties>
|
|
||||||
<parent>
|
<dependencies>
|
||||||
<groupId>fr.bigeon</groupId>
|
<dependency>
|
||||||
<artifactId>ebigeon-config</artifactId>
|
<groupId>net.bigeon</groupId>
|
||||||
<version>1.7.0</version>
|
<artifactId>gclc</artifactId>
|
||||||
</parent>
|
<version>2.0.11</version>
|
||||||
<dependencies>
|
</dependency>
|
||||||
<dependency>
|
<dependency>
|
||||||
<groupId>fr.bigeon</groupId>
|
<groupId>net.bigeon</groupId>
|
||||||
<artifactId>gclc</artifactId>
|
<artifactId>collections</artifactId>
|
||||||
<version>1.2.3</version>
|
<version>1.1.6</version>
|
||||||
</dependency>
|
</dependency>
|
||||||
<dependency>
|
</dependencies>
|
||||||
<groupId>fr.bigeon</groupId>
|
|
||||||
<artifactId>collections</artifactId>
|
<reporting>
|
||||||
<version>1.0.1</version>
|
<plugins>
|
||||||
</dependency>
|
<plugin>
|
||||||
</dependencies>
|
<groupId>org.apache.maven.plugins</groupId>
|
||||||
<inceptionYear>2015</inceptionYear>
|
<artifactId>maven-javadoc-plugin</artifactId>
|
||||||
<name>GCLC swt</name>
|
<version>2.10.3</version>
|
||||||
<description>provide a swt window for console applications</description>
|
</plugin>
|
||||||
<scm>
|
<plugin>
|
||||||
<developerConnection>scm:git:gogs@git.code.bigeon.net:emmanuel/gclc.git</developerConnection>
|
<groupId>com.github.sevntu-checkstyle</groupId>
|
||||||
<tag>HEAD</tag>
|
<artifactId>dsm-maven-plugin</artifactId>
|
||||||
</scm>
|
<version>2.2.0</version>
|
||||||
<profiles>
|
</plugin>
|
||||||
<profile>
|
</plugins>
|
||||||
<id>linux-deps</id>
|
</reporting>
|
||||||
<activation>
|
</project>
|
||||||
<os>
|
|
||||||
<family>Linux</family>
|
|
||||||
</os>
|
|
||||||
</activation>
|
|
||||||
<dependencies>
|
|
||||||
<dependency>
|
|
||||||
<groupId>org.eclipse.swt</groupId>
|
|
||||||
<artifactId>org.eclipse.swt.gtk.linux.x86_64</artifactId>
|
|
||||||
<version>4.3</version>
|
|
||||||
</dependency>
|
|
||||||
</dependencies>
|
|
||||||
</profile>
|
|
||||||
<profile>
|
|
||||||
<id>windows-deps</id>
|
|
||||||
<activation>
|
|
||||||
<os>
|
|
||||||
<family>Windows</family>
|
|
||||||
</os>
|
|
||||||
</activation>
|
|
||||||
<dependencies>
|
|
||||||
<dependency>
|
|
||||||
<groupId>org.eclipse.swt</groupId>
|
|
||||||
<artifactId>org.eclipse.swt.win32.win32.x86_64</artifactId>
|
|
||||||
<version>4.3</version>
|
|
||||||
</dependency>
|
|
||||||
</dependencies>
|
|
||||||
</profile>
|
|
||||||
</profiles>
|
|
||||||
</project>
|
|
||||||
|
|||||||
@@ -1,111 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright E. Bigeon (2015)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* provide a swt window for console applications.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
/**
|
|
||||||
* gclc-swt:fr.bigeon.gclc.swt.HistoryTextKeyListener.java
|
|
||||||
* Created on: Jun 9, 2016
|
|
||||||
*/
|
|
||||||
package fr.bigeon.gclc.swt;
|
|
||||||
|
|
||||||
import org.eclipse.swt.SWT;
|
|
||||||
import org.eclipse.swt.events.KeyAdapter;
|
|
||||||
import org.eclipse.swt.events.KeyEvent;
|
|
||||||
import org.eclipse.swt.widgets.Text;
|
|
||||||
|
|
||||||
import fr.bigeon.collections.ArrayRibbon;
|
|
||||||
import fr.bigeon.collections.Ribbon;
|
|
||||||
|
|
||||||
/** A key listener to validate commands and manage the history of commands
|
|
||||||
*
|
|
||||||
* @author Emmanuel Bigeon */
|
|
||||||
public final class HistoryTextKeyListener extends KeyAdapter {
|
|
||||||
|
|
||||||
/** The size of commands history */
|
|
||||||
private static final int DEFAULT_HISTORY_SIZE = 10;
|
|
||||||
/** The history ribbon */
|
|
||||||
private final Ribbon<String> commands;
|
|
||||||
/** The current index in history search */
|
|
||||||
private int currentIndex = 0;
|
|
||||||
/** The console to write the commands in */
|
|
||||||
private final Text consoleInput;
|
|
||||||
/** The console to notify of command validation */
|
|
||||||
private final SWTConsole console;
|
|
||||||
|
|
||||||
/** @param console the console
|
|
||||||
* @param consoleInput the text to write commands in */
|
|
||||||
public HistoryTextKeyListener(SWTConsole console, Text consoleInput) {
|
|
||||||
super();
|
|
||||||
this.console = console;
|
|
||||||
this.consoleInput = consoleInput;
|
|
||||||
this.commands = new ArrayRibbon<>(DEFAULT_HISTORY_SIZE);
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public void keyPressed(KeyEvent e) {
|
|
||||||
|
|
||||||
pressedKeyCode(e.keyCode);
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param keyCode */
|
|
||||||
public void pressedKeyCode(int keyCode) {
|
|
||||||
// Enter validates the command if prompting
|
|
||||||
if (keyCode == '\r') {
|
|
||||||
commands.add(consoleInput.getText());
|
|
||||||
console.validateInput();
|
|
||||||
currentIndex = -1;
|
|
||||||
}
|
|
||||||
|
|
||||||
// Upper arrow retrieves previous commands
|
|
||||||
if (keyCode == SWT.ARROW_UP &&
|
|
||||||
currentIndex < commands.size() - 1) {
|
|
||||||
currentIndex++;
|
|
||||||
String cmd = commands.get(commands.size() - currentIndex - 1);
|
|
||||||
consoleInput.setText(cmd);
|
|
||||||
consoleInput.setSelection(cmd.length());
|
|
||||||
}
|
|
||||||
|
|
||||||
// Lower arrow retrieves next commands
|
|
||||||
if (keyCode == SWT.ARROW_DOWN) {
|
|
||||||
if (currentIndex == 0) {
|
|
||||||
currentIndex--;
|
|
||||||
consoleInput.setText(new String());
|
|
||||||
} else if (currentIndex > 0) {
|
|
||||||
String cmd = commands
|
|
||||||
.get(commands.size() - (--currentIndex) - 1);
|
|
||||||
consoleInput.setText(cmd);
|
|
||||||
consoleInput.setSelection(cmd.length());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,335 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright E. Bigeon (2015)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* provide a swt window for console applications.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
/**
|
|
||||||
* gclc-swt:fr.bigeon.gclc.swt.SWTConsole.java
|
|
||||||
* Created on: Apr 18, 2015
|
|
||||||
*/
|
|
||||||
package fr.bigeon.gclc.swt;
|
|
||||||
|
|
||||||
import java.io.IOException;
|
|
||||||
import java.util.logging.Level;
|
|
||||||
import java.util.logging.Logger;
|
|
||||||
|
|
||||||
import org.eclipse.swt.SWT;
|
|
||||||
import org.eclipse.swt.events.FocusAdapter;
|
|
||||||
import org.eclipse.swt.events.FocusEvent;
|
|
||||||
import org.eclipse.swt.layout.GridData;
|
|
||||||
import org.eclipse.swt.layout.GridLayout;
|
|
||||||
import org.eclipse.swt.widgets.Composite;
|
|
||||||
import org.eclipse.swt.widgets.Display;
|
|
||||||
import org.eclipse.swt.widgets.Label;
|
|
||||||
import org.eclipse.swt.widgets.Text;
|
|
||||||
|
|
||||||
import fr.bigeon.gclc.ConsoleApplication;
|
|
||||||
import fr.bigeon.gclc.manager.ConsoleManager;
|
|
||||||
|
|
||||||
/** A SWT component to connect to gclc {@link ConsoleApplication}
|
|
||||||
* <p>
|
|
||||||
*
|
|
||||||
* @author Emmanuel Bigeon */
|
|
||||||
public class SWTConsole extends Composite implements ConsoleManager {
|
|
||||||
/**
|
|
||||||
*
|
|
||||||
*/
|
|
||||||
private static final int LAYOUT_NB_COLUMNS = 2;
|
|
||||||
/** The cmd prefix in the output console */
|
|
||||||
private static final String CMD_PREFIX = "[CMD] "; //$NON-NLS-1$
|
|
||||||
/** The class logger */
|
|
||||||
private static final Logger LOGGER = Logger
|
|
||||||
.getLogger(SWTConsole.class.getName());
|
|
||||||
/** The console output text field */
|
|
||||||
private final Text consoleOutput;
|
|
||||||
/** The console input text field */
|
|
||||||
private final Text consoleInput;
|
|
||||||
/** The prompt label */
|
|
||||||
private final Label lblPromptlabel;
|
|
||||||
/** The prompt text */
|
|
||||||
private String prompt = ">"; //$NON-NLS-1$
|
|
||||||
/** The command entered by the user */
|
|
||||||
private String command = null;
|
|
||||||
/** If the prompt should be active */
|
|
||||||
private boolean prompting = false;
|
|
||||||
/** The object for thread synchronization with the prompt */
|
|
||||||
private final Object promptLock = new Object();
|
|
||||||
|
|
||||||
/** Create the composite.
|
|
||||||
*
|
|
||||||
* @param parent the prent composite
|
|
||||||
* @param style the composite style */
|
|
||||||
public SWTConsole(Composite parent, int style) {
|
|
||||||
super(parent, style);
|
|
||||||
|
|
||||||
setLayout(new GridLayout(LAYOUT_NB_COLUMNS, false));
|
|
||||||
|
|
||||||
consoleOutput = new Text(this, SWT.BORDER | SWT.READ_ONLY | SWT.WRAP |
|
|
||||||
SWT.V_SCROLL | SWT.MULTI);
|
|
||||||
consoleOutput.setLayoutData(new GridData(SWT.FILL, SWT.FILL, true, true,
|
|
||||||
LAYOUT_NB_COLUMNS, 1));
|
|
||||||
consoleOutput.setRedraw(true);
|
|
||||||
consoleOutput.addFocusListener(new FocusAdapter() {
|
|
||||||
@SuppressWarnings("synthetic-access")
|
|
||||||
@Override
|
|
||||||
public void focusGained(FocusEvent e) {
|
|
||||||
consoleInput.setFocus();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
lblPromptlabel = new Label(this, SWT.NONE);
|
|
||||||
lblPromptlabel.setText(prompt);
|
|
||||||
|
|
||||||
consoleInput = new Text(this, SWT.BORDER);
|
|
||||||
consoleInput.setLayoutData(
|
|
||||||
new GridData(SWT.FILL, SWT.CENTER, true, false, 1, 1));
|
|
||||||
consoleInput
|
|
||||||
.addKeyListener(new HistoryTextKeyListener(this, consoleInput));
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
*
|
|
||||||
*/
|
|
||||||
protected void validateInput() {
|
|
||||||
Display.getDefault().syncExec(new Runnable() {
|
|
||||||
@SuppressWarnings("synthetic-access")
|
|
||||||
@Override
|
|
||||||
public void run() {
|
|
||||||
consoleInput.setEnabled(false);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
synchronized (promptLock) {
|
|
||||||
while (!prompting) {
|
|
||||||
try {
|
|
||||||
promptLock.wait();
|
|
||||||
} catch (InterruptedException e) {
|
|
||||||
LOGGER.log(Level.SEVERE,
|
|
||||||
"Interruption while waiting prompt", e); //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
}
|
|
||||||
Display.getDefault().syncExec(new Runnable() {
|
|
||||||
@SuppressWarnings("synthetic-access")
|
|
||||||
@Override
|
|
||||||
public void run() {
|
|
||||||
command = consoleInput.getText();
|
|
||||||
prompting = false;
|
|
||||||
consoleInput.setText(new String());
|
|
||||||
consoleOutput.append(
|
|
||||||
CMD_PREFIX + command + System.lineSeparator());
|
|
||||||
}
|
|
||||||
});
|
|
||||||
promptLock.notifyAll();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
protected void checkSubclass() {
|
|
||||||
// Disable the check that prevents subclassing of SWT components
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.ConsoleManager#getPrompt() */
|
|
||||||
@Override
|
|
||||||
public String getPrompt() {
|
|
||||||
return prompt;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.ConsoleManager#print(java.lang.String) */
|
|
||||||
@Override
|
|
||||||
public void print(final String text) {
|
|
||||||
Display.getDefault().syncExec(new Runnable() {
|
|
||||||
@SuppressWarnings("synthetic-access")
|
|
||||||
@Override
|
|
||||||
public void run() {
|
|
||||||
consoleOutput.append(text);
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.ConsoleManager#println() */
|
|
||||||
@Override
|
|
||||||
public void println() {
|
|
||||||
Display.getDefault().syncExec(new Runnable() {
|
|
||||||
@SuppressWarnings("synthetic-access")
|
|
||||||
@Override
|
|
||||||
public void run() {
|
|
||||||
consoleOutput.append(System.lineSeparator());
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.ConsoleManager#println(java.lang.String) */
|
|
||||||
@Override
|
|
||||||
public void println(final String message) {
|
|
||||||
Display.getDefault().syncExec(new Runnable() {
|
|
||||||
@SuppressWarnings("synthetic-access")
|
|
||||||
@Override
|
|
||||||
public void run() {
|
|
||||||
consoleOutput.append(message + System.lineSeparator());
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.ConsoleManager#prompt() */
|
|
||||||
@Override
|
|
||||||
public String prompt() throws IOException {
|
|
||||||
synchronized (promptLock) {
|
|
||||||
if (isDisposed()) {
|
|
||||||
throw new IOException();
|
|
||||||
}
|
|
||||||
try {
|
|
||||||
Display.getDefault().syncExec(new Runnable() {
|
|
||||||
@SuppressWarnings("synthetic-access")
|
|
||||||
@Override
|
|
||||||
public void run() {
|
|
||||||
consoleInput.setEnabled(true);
|
|
||||||
consoleInput.setFocus();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
prompting = true;
|
|
||||||
promptLock.notifyAll();
|
|
||||||
promptLock.wait();
|
|
||||||
} catch (final InterruptedException e) {
|
|
||||||
command = null;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if (isDisposed()) {
|
|
||||||
throw new IOException("Input closed"); //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
return command;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.ConsoleManager#prompt(java.lang.String) */
|
|
||||||
@Override
|
|
||||||
public String prompt(final String message) throws IOException {
|
|
||||||
synchronized (promptLock) {
|
|
||||||
if (isDisposed()) {
|
|
||||||
throw new IOException();
|
|
||||||
}
|
|
||||||
try {
|
|
||||||
Display.getDefault().syncExec(new Runnable() {
|
|
||||||
@SuppressWarnings("synthetic-access")
|
|
||||||
@Override
|
|
||||||
public void run() {
|
|
||||||
lblPromptlabel.setText(message);
|
|
||||||
// relayout
|
|
||||||
SWTConsole.this.layout();
|
|
||||||
consoleInput.setEnabled(true);
|
|
||||||
consoleInput.setFocus();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
prompting = true;
|
|
||||||
promptLock.wait();
|
|
||||||
if (isDisposed()) {
|
|
||||||
throw new IOException();
|
|
||||||
}
|
|
||||||
} catch (final InterruptedException e) {
|
|
||||||
command = null;
|
|
||||||
} finally {
|
|
||||||
Display.getDefault().syncExec(new Runnable() {
|
|
||||||
@SuppressWarnings("synthetic-access")
|
|
||||||
@Override
|
|
||||||
public void run() {
|
|
||||||
lblPromptlabel.setText(prompt);
|
|
||||||
// relayout
|
|
||||||
SWTConsole.this.layout();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return command;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see org.eclipse.swt.widgets.Composite#setFocus() */
|
|
||||||
@Override
|
|
||||||
public boolean setFocus() {
|
|
||||||
return consoleInput.setFocus();
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.ConsoleManager#setPrompt(java.lang.String) */
|
|
||||||
@Override
|
|
||||||
public void setPrompt(final String prompt) {
|
|
||||||
this.prompt = prompt;
|
|
||||||
Display.getDefault().syncExec(new Runnable() {
|
|
||||||
@SuppressWarnings("synthetic-access")
|
|
||||||
@Override
|
|
||||||
public void run() {
|
|
||||||
lblPromptlabel.setText(prompt);
|
|
||||||
// relayout
|
|
||||||
SWTConsole.this.layout();
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.manager.ConsoleManager#close() */
|
|
||||||
@Override
|
|
||||||
public void close() {
|
|
||||||
synchronized (promptLock) {
|
|
||||||
promptLock.notify();
|
|
||||||
}
|
|
||||||
if (consoleInput.isDisposed()) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
consoleInput.setEnabled(false);
|
|
||||||
consoleOutput.setEnabled(false);
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.manager.ConsoleManager#isClosed() */
|
|
||||||
@Override
|
|
||||||
public boolean isClosed() {
|
|
||||||
return isDisposed();
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param string the text */
|
|
||||||
public void setText(String string) {
|
|
||||||
consoleInput.setText(string);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
*
|
|
||||||
*/
|
|
||||||
public void validateCommand() {
|
|
||||||
validateInput();
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
@@ -0,0 +1,91 @@
|
|||||||
|
/*
|
||||||
|
* GCLC swt, provide a swt window for console applications
|
||||||
|
* Copyright (C) 2015-2017 E. Bigeon
|
||||||
|
* mailto:emmanuel@bigeon.fr
|
||||||
|
*
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
*/
|
||||||
|
/**
|
||||||
|
* gclc-swt:net.bigeon.gclc.swt.ConsoleDelayIO.java
|
||||||
|
* Created on: Nov 19, 2016
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.swt;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* GCLC swt
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2015 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
/** This class represents an object used to send commands to a console
|
||||||
|
* application.
|
||||||
|
* <p>
|
||||||
|
* The sending of command is done in two phases. Define the input through get
|
||||||
|
* and set, and then validate the input.
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public interface ConsoleDelayIO {
|
||||||
|
/** Get the input text.
|
||||||
|
*
|
||||||
|
* @return the non validated input */
|
||||||
|
String getInput();
|
||||||
|
|
||||||
|
/** Set the input text.
|
||||||
|
*
|
||||||
|
* @param input the input to set */
|
||||||
|
void setInput(String input);
|
||||||
|
|
||||||
|
/** Actually send the input as the prompt next input. */
|
||||||
|
void validateInput();
|
||||||
|
}
|
||||||
@@ -0,0 +1,146 @@
|
|||||||
|
/*
|
||||||
|
* GCLC swt, provide a swt window for console applications
|
||||||
|
* Copyright (C) 2015-2017 E. Bigeon
|
||||||
|
* mailto:emmanuel@bigeon.fr
|
||||||
|
*
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
*/
|
||||||
|
/**
|
||||||
|
* gclc-swt:net.bigeon.gclc.swt.HistoryTextKeyListener.java
|
||||||
|
* Created on: Jun 9, 2016
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.swt;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* GCLC swt
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2015 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import org.eclipse.swt.SWT;
|
||||||
|
import org.eclipse.swt.events.KeyAdapter;
|
||||||
|
import org.eclipse.swt.events.KeyEvent;
|
||||||
|
|
||||||
|
import net.bigeon.collections.ArrayRibbon;
|
||||||
|
import net.bigeon.collections.Ribbon;
|
||||||
|
|
||||||
|
/** A key listener to validate commands and manage the history of commands.
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public final class HistoryTextKeyListener extends KeyAdapter {
|
||||||
|
|
||||||
|
/** The size of commands history. */
|
||||||
|
private static final int DEFAULT_HISTORY_SIZE = 10;
|
||||||
|
/** The empty string constant. */
|
||||||
|
private static final String EMPTY = ""; //$NON-NLS-1$
|
||||||
|
/** The history ribbon. */
|
||||||
|
private final Ribbon<String> commands;
|
||||||
|
/** The current index in history search. */
|
||||||
|
private int currentIndex = 0;
|
||||||
|
/** The console to notify of command validation. */
|
||||||
|
private final ConsoleDelayIO console;
|
||||||
|
|
||||||
|
/** Create the key listener that cycle the history.
|
||||||
|
*
|
||||||
|
* @param console the console delayed */
|
||||||
|
public HistoryTextKeyListener(final ConsoleDelayIO console) {
|
||||||
|
super();
|
||||||
|
this.console = console;
|
||||||
|
commands = new ArrayRibbon<>(DEFAULT_HISTORY_SIZE);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see org.eclipse.swt.events.KeyAdapter#keyPressed(org.eclipse.swt.events.
|
||||||
|
* KeyEvent) */
|
||||||
|
@Override
|
||||||
|
public void keyPressed(final KeyEvent e) {
|
||||||
|
pressedKeyCode(e.keyCode);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Indicate a pressed key combination.
|
||||||
|
*
|
||||||
|
* @param keyCode the pressed key code */
|
||||||
|
public void pressedKeyCode(final int keyCode) {
|
||||||
|
// Enter validates the command if prompting
|
||||||
|
if (keyCode == '\r') {
|
||||||
|
final String input = console.getInput();
|
||||||
|
if (!input.isEmpty()) {
|
||||||
|
commands.add(input);
|
||||||
|
}
|
||||||
|
console.validateInput();
|
||||||
|
currentIndex = -1;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Upper arrow retrieves previous commands
|
||||||
|
if (keyCode == SWT.ARROW_UP && currentIndex < commands.size() - 1) {
|
||||||
|
currentIndex++;
|
||||||
|
final String cmd = commands.get(commands.size() - currentIndex - 1);
|
||||||
|
console.setInput(cmd);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Lower arrow retrieves next commands
|
||||||
|
if (keyCode == SWT.ARROW_DOWN) {
|
||||||
|
if (currentIndex <= 0) {
|
||||||
|
if (currentIndex == 0) {
|
||||||
|
console.setInput(EMPTY);
|
||||||
|
}
|
||||||
|
currentIndex = -1;
|
||||||
|
} else {
|
||||||
|
currentIndex--;
|
||||||
|
final String cmd = commands.get(commands.size() - currentIndex - 1);
|
||||||
|
console.setInput(cmd);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
478
gclc-swt/src/main/java/net/bigeon/gclc/swt/SWTConsole.java
Normal file
478
gclc-swt/src/main/java/net/bigeon/gclc/swt/SWTConsole.java
Normal file
@@ -0,0 +1,478 @@
|
|||||||
|
/*
|
||||||
|
* GCLC swt, provide a swt window for console applications
|
||||||
|
* Copyright (C) 2015-2017 E. Bigeon
|
||||||
|
* mailto:emmanuel@bigeon.fr
|
||||||
|
*
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
*/
|
||||||
|
/**
|
||||||
|
* gclc-swt:net.bigeon.gclc.swt.SWTConsole.java
|
||||||
|
* Created on: Apr 18, 2015
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.swt;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* GCLC swt
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2015 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.util.logging.Level;
|
||||||
|
import java.util.logging.Logger;
|
||||||
|
|
||||||
|
import org.eclipse.swt.SWT;
|
||||||
|
import org.eclipse.swt.layout.GridData;
|
||||||
|
import org.eclipse.swt.layout.GridLayout;
|
||||||
|
import org.eclipse.swt.widgets.Composite;
|
||||||
|
import org.eclipse.swt.widgets.Display;
|
||||||
|
import org.eclipse.swt.widgets.Label;
|
||||||
|
import org.eclipse.swt.widgets.Text;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.ConsoleApplication;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleInput;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleOutput;
|
||||||
|
import net.bigeon.gclc.tools.ConstantString;
|
||||||
|
import net.bigeon.gclc.tools.StringProvider;
|
||||||
|
|
||||||
|
/** A SWT component to connect to gclc {@link ConsoleApplication}.
|
||||||
|
* <p>
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public final class SWTConsole extends Composite
|
||||||
|
implements ConsoleDelayIO, ConsoleInput, ConsoleOutput {
|
||||||
|
private static final int TWO = 2;
|
||||||
|
private static final String ERROR_SYNCHRO_PROMPT = "Error in synchronization of prompting";
|
||||||
|
/** The number of columns of the layout. */
|
||||||
|
private static final int LAYOUT_NB_COLUMNS = 2;
|
||||||
|
/** The cmd prefix in the output console. */
|
||||||
|
private static final String CMD_PREFIX = "[CMD] "; //$NON-NLS-1$
|
||||||
|
/** The class logger. */
|
||||||
|
private static final Logger LOGGER = Logger
|
||||||
|
.getLogger(SWTConsole.class.getName());
|
||||||
|
/** The empty string constant. */
|
||||||
|
private static final String EMPTY = ""; //$NON-NLS-1$
|
||||||
|
|
||||||
|
/** The console output text field. */
|
||||||
|
private final Text consoleOutput;
|
||||||
|
/** The console input text field. */
|
||||||
|
private final Text consoleInput;
|
||||||
|
/** The prompt label. */
|
||||||
|
private final Label lblPromptlabel;
|
||||||
|
/** The prompt text. */
|
||||||
|
private StringProvider prompt = new ConstantString("> "); //$NON-NLS-1$
|
||||||
|
/** The command entered by the user. */
|
||||||
|
private String command = null;
|
||||||
|
/** If the prompt should be active. */
|
||||||
|
private boolean prompting = false;
|
||||||
|
/** The object for thread synchronization with the prompt. */
|
||||||
|
private final Object promptLock = new Object();
|
||||||
|
|
||||||
|
/** Create the composite.
|
||||||
|
*
|
||||||
|
* @param parent the prent composite
|
||||||
|
* @param style the composite style */
|
||||||
|
public SWTConsole(final Composite parent, final int style) {
|
||||||
|
super(parent, style);
|
||||||
|
|
||||||
|
setLayout(new GridLayout(LAYOUT_NB_COLUMNS, false));
|
||||||
|
|
||||||
|
consoleOutput = new Text(this,
|
||||||
|
SWT.BORDER | SWT.READ_ONLY | SWT.WRAP | SWT.V_SCROLL | SWT.MULTI);
|
||||||
|
consoleOutput.setLayoutData(
|
||||||
|
new GridData(SWT.FILL, SWT.FILL, true, true, LAYOUT_NB_COLUMNS, 1));
|
||||||
|
consoleOutput.setRedraw(true);
|
||||||
|
|
||||||
|
lblPromptlabel = new Label(this, SWT.NONE);
|
||||||
|
lblPromptlabel.setText(prompt.apply());
|
||||||
|
|
||||||
|
consoleInput = new Text(this, SWT.BORDER);
|
||||||
|
consoleInput.setLayoutData(new GridData(SWT.FILL, SWT.CENTER, true, false, 1, 1));
|
||||||
|
consoleInput.addKeyListener(new HistoryTextKeyListener(this));
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see org.eclipse.swt.widgets.Composite#checkSubclass() */
|
||||||
|
@Override
|
||||||
|
protected void checkSubclass() {
|
||||||
|
// Disable the check that prevents subclassing of SWT components
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleManager#close() */
|
||||||
|
@Override
|
||||||
|
public void close() {
|
||||||
|
synchronized (promptLock) {
|
||||||
|
prompting = false;
|
||||||
|
promptLock.notifyAll();
|
||||||
|
}
|
||||||
|
if (consoleInput.isDisposed()) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
consoleInput.setEnabled(false);
|
||||||
|
consoleOutput.setEnabled(false);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.swt.ConsoleDelayIO#getInput() */
|
||||||
|
@Override
|
||||||
|
public String getInput() {
|
||||||
|
return consoleInput.getText();
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.ConsoleManager#getPrompt() */
|
||||||
|
@Override
|
||||||
|
public StringProvider getPrompt() {
|
||||||
|
return prompt;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleManager#interruptPrompt() */
|
||||||
|
@Override
|
||||||
|
public void interruptPrompt() {
|
||||||
|
synchronized (promptLock) {
|
||||||
|
promptLock.notifyAll();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleManager#isClosed() */
|
||||||
|
@Override
|
||||||
|
public boolean isClosed() {
|
||||||
|
return isDisposed();
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.ConsoleManager#print(java.lang.String) */
|
||||||
|
@Override
|
||||||
|
public void print(final String text) throws IOException {
|
||||||
|
if (isDisposed()) {
|
||||||
|
throw new IOException();
|
||||||
|
}
|
||||||
|
Display.getDefault().syncExec(new Runnable() {
|
||||||
|
@SuppressWarnings("synthetic-access")
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
if (!consoleOutput.isDisposed()) {
|
||||||
|
consoleOutput.append(text);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.ConsoleManager#println() */
|
||||||
|
@Override
|
||||||
|
public void println() throws IOException {
|
||||||
|
if (isDisposed()) {
|
||||||
|
throw new IOException();
|
||||||
|
}
|
||||||
|
Display.getDefault().syncExec(new Runnable() {
|
||||||
|
@SuppressWarnings("synthetic-access")
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
if (!consoleOutput.isDisposed()) {
|
||||||
|
consoleOutput.append(System.lineSeparator());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.ConsoleManager#println(java.lang.String) */
|
||||||
|
@Override
|
||||||
|
public void println(final String message) throws IOException {
|
||||||
|
if (isDisposed()) {
|
||||||
|
throw new IOException();
|
||||||
|
}
|
||||||
|
Display.getDefault().syncExec(new Runnable() {
|
||||||
|
@SuppressWarnings("synthetic-access")
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
if (!consoleOutput.isDisposed()) {
|
||||||
|
consoleOutput.append(message + System.lineSeparator());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.ConsoleManager#prompt() */
|
||||||
|
@Override
|
||||||
|
public String prompt() throws IOException {
|
||||||
|
synchronized (promptLock) {
|
||||||
|
initPrompt(prompt.apply());
|
||||||
|
promptLock.notifyAll();
|
||||||
|
try {
|
||||||
|
while (prompting) {
|
||||||
|
promptLock.wait();
|
||||||
|
}
|
||||||
|
} catch (final InterruptedException e) {
|
||||||
|
LOGGER.log(Level.WARNING, ERROR_SYNCHRO_PROMPT, e);
|
||||||
|
command = null;
|
||||||
|
Thread.currentThread().interrupt();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (isDisposed()) {
|
||||||
|
throw new IOException("Input closed"); //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
return command;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Initialize the prompting.
|
||||||
|
*
|
||||||
|
* @param message the prompt message
|
||||||
|
* @throws IOException if the console is disposed */
|
||||||
|
private void initPrompt(final String message) throws IOException {
|
||||||
|
if (isDisposed()) {
|
||||||
|
throw new IOException();
|
||||||
|
}
|
||||||
|
Display.getDefault().syncExec(new Runnable() {
|
||||||
|
@SuppressWarnings("synthetic-access")
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
if (!consoleOutput.isDisposed()) {
|
||||||
|
lblPromptlabel.setText(message);
|
||||||
|
// relayout
|
||||||
|
SWTConsole.this.layout();
|
||||||
|
consoleInput.setEnabled(true);
|
||||||
|
consoleInput.setFocus();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
prompting = true;
|
||||||
|
command = null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleInput#prompt(long) */
|
||||||
|
@Override
|
||||||
|
public String prompt(final long timeout) throws IOException {
|
||||||
|
synchronized (promptLock) {
|
||||||
|
initPrompt(prompt.apply());
|
||||||
|
promptLock.notifyAll();
|
||||||
|
try {
|
||||||
|
waitPromptResolution(timeout);
|
||||||
|
} catch (final InterruptedException e) {
|
||||||
|
LOGGER.log(Level.WARNING, ERROR_SYNCHRO_PROMPT, e);
|
||||||
|
command = null;
|
||||||
|
Thread.currentThread().interrupt();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return command;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.ConsoleManager#prompt(java.lang.String) */
|
||||||
|
@Override
|
||||||
|
public String prompt(final String message) throws IOException {
|
||||||
|
synchronized (promptLock) {
|
||||||
|
initPrompt(message);
|
||||||
|
promptLock.notifyAll();
|
||||||
|
try {
|
||||||
|
while (prompting) {
|
||||||
|
promptLock.wait();
|
||||||
|
}
|
||||||
|
if (isDisposed()) {
|
||||||
|
throw new IOException();
|
||||||
|
}
|
||||||
|
} catch (final InterruptedException e) {
|
||||||
|
LOGGER.log(Level.WARNING, ERROR_SYNCHRO_PROMPT, e);
|
||||||
|
command = null;
|
||||||
|
Thread.currentThread().interrupt();
|
||||||
|
} finally {
|
||||||
|
resetPrompt();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return command;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.manager.ConsoleInput#prompt(java.lang.String, long) */
|
||||||
|
@Override
|
||||||
|
public String prompt(final String message, final long timeout) throws IOException {
|
||||||
|
synchronized (promptLock) {
|
||||||
|
initPrompt(message);
|
||||||
|
promptLock.notifyAll();
|
||||||
|
try {
|
||||||
|
waitPromptResolution(timeout);
|
||||||
|
} catch (final InterruptedException e) {
|
||||||
|
LOGGER.log(Level.WARNING, ERROR_SYNCHRO_PROMPT, e);
|
||||||
|
command = null;
|
||||||
|
Thread.currentThread().interrupt();
|
||||||
|
} finally {
|
||||||
|
resetPrompt();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return command;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Wait the prompt resolution by user.
|
||||||
|
*
|
||||||
|
* @param timeout the timeout for the wait
|
||||||
|
* @throws InterruptedException if the thread is interrupted
|
||||||
|
* @throws IOException if the console is disposed. */
|
||||||
|
private void waitPromptResolution(final long timeout)
|
||||||
|
throws InterruptedException, IOException {
|
||||||
|
final long start = System.currentTimeMillis();
|
||||||
|
long cur = start;
|
||||||
|
while (prompting && start + timeout > cur) {
|
||||||
|
promptLock.wait((cur - start - timeout) / TWO);
|
||||||
|
cur = System.currentTimeMillis();
|
||||||
|
}
|
||||||
|
if (isDisposed()) {
|
||||||
|
throw new IOException();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Reset the prompt message. */
|
||||||
|
private void resetPrompt() {
|
||||||
|
Display.getDefault().syncExec(new Runnable() {
|
||||||
|
@SuppressWarnings("synthetic-access")
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
if (!consoleOutput.isDisposed()) {
|
||||||
|
lblPromptlabel.setText(prompt.apply());
|
||||||
|
// relayout
|
||||||
|
SWTConsole.this.layout();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see org.eclipse.swt.widgets.Composite#setFocus() */
|
||||||
|
@Override
|
||||||
|
public boolean setFocus() {
|
||||||
|
return consoleInput.setFocus();
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.swt.ConsoleDelayIO#setInput(java.lang.String) */
|
||||||
|
@Override
|
||||||
|
public void setInput(final String input) {
|
||||||
|
consoleInput.setText(input);
|
||||||
|
consoleInput.setSelection(input.length());
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.manager.ConsoleInput#setPrompt(java.lang.String) */
|
||||||
|
@Override
|
||||||
|
public void setPrompt(final String prompt) {
|
||||||
|
setPrompt(new ConstantString(prompt));
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.ConsoleManager#setPrompt(java.lang.String) */
|
||||||
|
@Override
|
||||||
|
public void setPrompt(final StringProvider prompt) {
|
||||||
|
this.prompt = prompt;
|
||||||
|
Display.getDefault().syncExec(new Runnable() {
|
||||||
|
@SuppressWarnings("synthetic-access")
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
if (!consoleOutput.isDisposed()) {
|
||||||
|
lblPromptlabel.setText(prompt.apply());
|
||||||
|
// relayout
|
||||||
|
SWTConsole.this.layout();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Set the input text.
|
||||||
|
*
|
||||||
|
* @param string the text */
|
||||||
|
public void setText(final String string) {
|
||||||
|
consoleInput.setText(string);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.swt.ConsoleDelayIO#validateInput() */
|
||||||
|
@Override
|
||||||
|
public void validateInput() {
|
||||||
|
Display.getDefault().syncExec(new Runnable() {
|
||||||
|
@SuppressWarnings("synthetic-access")
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
consoleInput.setEnabled(false);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
synchronized (promptLock) {
|
||||||
|
while (!prompting) {
|
||||||
|
try {
|
||||||
|
promptLock.wait();
|
||||||
|
} catch (final InterruptedException e) {
|
||||||
|
LOGGER.log(Level.SEVERE, "Interruption while waiting prompt", e); //$NON-NLS-1$
|
||||||
|
Thread.currentThread().interrupt();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
Display.getDefault().syncExec(new Runnable() {
|
||||||
|
@SuppressWarnings("synthetic-access")
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
command = consoleInput.getText();
|
||||||
|
prompting = false;
|
||||||
|
consoleInput.setText(EMPTY);
|
||||||
|
consoleOutput.append(CMD_PREFIX + command + System.lineSeparator());
|
||||||
|
}
|
||||||
|
});
|
||||||
|
promptLock.notifyAll();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
@@ -1,90 +1,118 @@
|
|||||||
/*
|
/*
|
||||||
* Copyright E. Bigeon (2015)
|
* GCLC swt, provide a swt window for console applications
|
||||||
*
|
* Copyright (C) 2015-2017 E. Bigeon
|
||||||
* emmanuel@bigeon.fr
|
* mailto:emmanuel@bigeon.fr
|
||||||
*
|
*
|
||||||
* This software is a computer program whose purpose is to
|
* This software is governed by the CeCILL license under French law and
|
||||||
* provide a swt window for console applications.
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
*
|
* modify and/or redistribute the software under the terms of the CeCILL
|
||||||
* This software is governed by the CeCILL license under French law and
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
* "http://www.cecill.info".
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
*
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
* "http://www.cecill.info".
|
* modify and redistribute granted by the license, users are provided only
|
||||||
*
|
* with a limited warranty and the software's author, the holder of the
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
* economic rights, and the successive licensors have only limited
|
||||||
* modify and redistribute granted by the license, users are provided only
|
* liability.
|
||||||
* with a limited warranty and the software's author, the holder of the
|
*
|
||||||
* economic rights, and the successive licensors have only limited
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
* liability.
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
*
|
* software by the user in light of its specific status of free software,
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
* therefore means that it is reserved for developers and experienced
|
||||||
* software by the user in light of its specific status of free software,
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
* encouraged to load and test the software's suitability as regards their
|
||||||
* therefore means that it is reserved for developers and experienced
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
* encouraged to load and test the software's suitability as regards their
|
* same conditions as regards security.
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
*
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
* The fact that you are presently reading this means that you have had
|
||||||
* same conditions as regards security.
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
*
|
*/
|
||||||
* The fact that you are presently reading this means that you have had
|
/**
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
* gclc-swt:net.bigeon.gclc.swt.SWTConsoleShell.java
|
||||||
*/
|
* Created on: Apr 18, 2015
|
||||||
/**
|
*/
|
||||||
* gclc-swt:fr.bigeon.gclc.swt.SWTConsoleShell.java
|
package net.bigeon.gclc.swt;
|
||||||
* Created on: Apr 18, 2015
|
|
||||||
*/
|
/*-
|
||||||
package fr.bigeon.gclc.swt;
|
* #%L
|
||||||
|
* GCLC swt
|
||||||
import org.eclipse.swt.SWT;
|
* %%
|
||||||
import org.eclipse.swt.layout.FillLayout;
|
* Copyright (C) 2015 - 2018 Bigeon
|
||||||
import org.eclipse.swt.widgets.Display;
|
* %%
|
||||||
import org.eclipse.swt.widgets.Shell;
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
import fr.bigeon.gclc.manager.ConsoleManager;
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
/** A shell containing a {@link SWTConsole}
|
* "http://www.cecill.info".
|
||||||
* <p>
|
*
|
||||||
*
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
* @author Emmanuel Bigeon */
|
* modify and redistribute granted by the license, users are provided only
|
||||||
public class SWTConsoleShell extends Shell {
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
/** The console component */
|
* liability.
|
||||||
private SWTConsole console;
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
/** Create the shell.
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
*
|
* software by the user in light of its specific status of free software,
|
||||||
* @param display the display */
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
public SWTConsoleShell(Display display) {
|
* therefore means that it is reserved for developers and experienced
|
||||||
super(display, SWT.SHELL_TRIM);
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
setLayout(new FillLayout(SWT.HORIZONTAL));
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
createContents();
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
}
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
@Override
|
* The fact that you are presently reading this means that you have had
|
||||||
protected void checkSubclass() {
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
// Disable the check that prevents subclassing of SWT components
|
* #L%
|
||||||
}
|
*/
|
||||||
|
import org.eclipse.swt.SWT;
|
||||||
/** Create contents of the shell. */
|
import org.eclipse.swt.layout.FillLayout;
|
||||||
protected void createContents() {
|
import org.eclipse.swt.widgets.Display;
|
||||||
console = new SWTConsole(this, SWT.NONE);
|
import org.eclipse.swt.widgets.Shell;
|
||||||
setText("Console Application"); //$NON-NLS-1$
|
|
||||||
}
|
/** A shell containing a {@link SWTConsole}
|
||||||
|
* <p>
|
||||||
/** @return the console manager */
|
*
|
||||||
public ConsoleManager getManager() {
|
* @author Emmanuel Bigeon */
|
||||||
return console;
|
public final class SWTConsoleShell extends Shell {
|
||||||
}
|
|
||||||
|
/** The console component */
|
||||||
/* (non-Javadoc)
|
private SWTConsole console;
|
||||||
* @see org.eclipse.swt.widgets.Shell#dispose() */
|
|
||||||
@Override
|
/** Create the shell.
|
||||||
public void dispose() {
|
*
|
||||||
super.dispose();
|
* @param display the display */
|
||||||
console.close();
|
public SWTConsoleShell(final Display display, final int style) {
|
||||||
}
|
super(display, style);
|
||||||
}
|
setLayout(new FillLayout(SWT.HORIZONTAL));
|
||||||
|
|
||||||
|
createContents();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
protected void checkSubclass() {
|
||||||
|
// Disable the check that prevents subclassing of SWT components
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Create contents of the shell. */
|
||||||
|
private void createContents() {
|
||||||
|
console = new SWTConsole(this, SWT.NONE);
|
||||||
|
setText("Console Application"); //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see org.eclipse.swt.widgets.Shell#dispose() */
|
||||||
|
@Override
|
||||||
|
public void dispose() {
|
||||||
|
super.dispose();
|
||||||
|
console.close();
|
||||||
|
}
|
||||||
|
|
||||||
|
/** @return the input and output. */
|
||||||
|
public SWTConsole getManager() {
|
||||||
|
return console;
|
||||||
|
}
|
||||||
|
}
|
||||||
220
gclc-swt/src/main/java/net/bigeon/gclc/swt/SWTConsoleView.java
Normal file
220
gclc-swt/src/main/java/net/bigeon/gclc/swt/SWTConsoleView.java
Normal file
@@ -0,0 +1,220 @@
|
|||||||
|
/*
|
||||||
|
* GCLC swt, provide a swt window for console applications
|
||||||
|
* Copyright (C) 2015-2017 E. Bigeon
|
||||||
|
* mailto:emmanuel@bigeon.fr
|
||||||
|
*
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
*/
|
||||||
|
/**
|
||||||
|
* gclc-swt:net.bigeon.gclc.swt.SWTConsole.java
|
||||||
|
* Created on: Apr 18, 2015
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.swt;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* GCLC swt
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2015 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.util.logging.Level;
|
||||||
|
import java.util.logging.Logger;
|
||||||
|
|
||||||
|
import org.eclipse.swt.SWT;
|
||||||
|
import org.eclipse.swt.layout.GridData;
|
||||||
|
import org.eclipse.swt.layout.GridLayout;
|
||||||
|
import org.eclipse.swt.widgets.Composite;
|
||||||
|
import org.eclipse.swt.widgets.Display;
|
||||||
|
import org.eclipse.swt.widgets.Text;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.ConsoleApplication;
|
||||||
|
import net.bigeon.gclc.utils.AOutputForwardRunnable;
|
||||||
|
import net.bigeon.gclc.utils.PipedConsoleInput;
|
||||||
|
import net.bigeon.gclc.utils.PipedConsoleOutput;
|
||||||
|
|
||||||
|
/** A SWT component to connect to gclc {@link ConsoleApplication}
|
||||||
|
* <p>
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public final class SWTConsoleView extends Composite implements ConsoleDelayIO {
|
||||||
|
/** The local implementation of the forwarding runnable
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
private final class ToSWTConsoleForwardRunnable extends AOutputForwardRunnable {
|
||||||
|
/** The running status */
|
||||||
|
private boolean running = true;
|
||||||
|
|
||||||
|
/** @param manager the manager */
|
||||||
|
public ToSWTConsoleForwardRunnable(final PipedConsoleOutput manager) {
|
||||||
|
super(manager);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
protected void forwardLine(final String m) {
|
||||||
|
appendConsoleOutput(System.lineSeparator() + m);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
protected boolean isRunning() {
|
||||||
|
return running && !isDisposed();
|
||||||
|
}
|
||||||
|
|
||||||
|
/** @param running the running to set */
|
||||||
|
public void setRunning(final boolean running) {
|
||||||
|
this.running = running;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** The class logger */
|
||||||
|
private static final Logger LOGGER = Logger
|
||||||
|
.getLogger(SWTConsoleView.class.getName());
|
||||||
|
/** The console output text field */
|
||||||
|
private final Text consoleOutput;
|
||||||
|
/** The console input text field */
|
||||||
|
private final Text consoleInput;
|
||||||
|
/** The input. */
|
||||||
|
private PipedConsoleInput input;
|
||||||
|
/** The forwarding runnable */
|
||||||
|
private ToSWTConsoleForwardRunnable forward;
|
||||||
|
|
||||||
|
/** Create the composite.
|
||||||
|
*
|
||||||
|
* @param parent the prent composite
|
||||||
|
* @param style the composite style */
|
||||||
|
public SWTConsoleView(final Composite parent, final int style) {
|
||||||
|
super(parent, style);
|
||||||
|
|
||||||
|
setLayout(new GridLayout(1, false));
|
||||||
|
|
||||||
|
consoleOutput = new Text(this,
|
||||||
|
SWT.BORDER | SWT.READ_ONLY | SWT.WRAP | SWT.V_SCROLL | SWT.MULTI);
|
||||||
|
consoleOutput.setLayoutData(new GridData(SWT.FILL, SWT.FILL, true, true, 1, 1));
|
||||||
|
consoleOutput.setRedraw(true);
|
||||||
|
|
||||||
|
consoleInput = new Text(this, SWT.BORDER);
|
||||||
|
consoleInput.setLayoutData(new GridData(SWT.FILL, SWT.CENTER, true, false, 1, 1));
|
||||||
|
consoleInput.addKeyListener(new HistoryTextKeyListener(this));
|
||||||
|
}
|
||||||
|
|
||||||
|
/** @param next the next message */
|
||||||
|
public void appendConsoleOutput(final String next) {
|
||||||
|
Display.getDefault().syncExec(new Runnable() {
|
||||||
|
@SuppressWarnings("synthetic-access")
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
consoleOutput.append(next);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
protected void checkSubclass() {
|
||||||
|
// Disable the check that prevents subclassing of SWT components
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.swt.ConsoleDelayIO#getInput() */
|
||||||
|
@Override
|
||||||
|
public String getInput() {
|
||||||
|
return consoleInput.getText();
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see org.eclipse.swt.widgets.Composite#setFocus() */
|
||||||
|
@Override
|
||||||
|
public boolean setFocus() {
|
||||||
|
return consoleInput.setFocus();
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see net.bigeon.gclc.swt.ConsoleDelayIO#setInput(java.lang.String) */
|
||||||
|
@Override
|
||||||
|
public void setInput(final String input) {
|
||||||
|
consoleInput.setText(input);
|
||||||
|
consoleInput.setSelection(input.length());
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Set the input and output.
|
||||||
|
*
|
||||||
|
* @param manager the output to set
|
||||||
|
* @param input the input */
|
||||||
|
public void setManager(final PipedConsoleOutput manager,
|
||||||
|
final PipedConsoleInput input) {
|
||||||
|
this.input = input;
|
||||||
|
if (forward != null) {
|
||||||
|
forward.setRunning(false);
|
||||||
|
}
|
||||||
|
forward = new ToSWTConsoleForwardRunnable(manager);
|
||||||
|
final Thread th = new Thread(forward, "gclcToSWT"); //$NON-NLS-1$
|
||||||
|
th.start();
|
||||||
|
}
|
||||||
|
|
||||||
|
/** @param string the text */
|
||||||
|
public void setText(final String string) {
|
||||||
|
consoleInput.setText(string);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
@Override
|
||||||
|
public void validateInput() {
|
||||||
|
try {
|
||||||
|
input.type(getInput());
|
||||||
|
} catch (final IOException e) {
|
||||||
|
LOGGER.log(Level.SEVERE, "Unable to input value to console", e); //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,53 +1,38 @@
|
|||||||
/*
|
/** SWT components for a frontend of GCLC applications.
|
||||||
* Copyright Bigeon Emmanuel (2014)
|
*
|
||||||
*
|
* @author Emmanuel Bigeon */
|
||||||
* emmanuel@bigeon.fr
|
package net.bigeon.gclc.swt;
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
/*-
|
||||||
* provide a generic framework for console applications.
|
* #%L
|
||||||
*
|
* GCLC swt
|
||||||
* This software is governed by the CeCILL license under French law and
|
* %%
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
* Copyright (C) 2015 - 2018 Bigeon
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
* %%
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
* This software is governed by the CeCILL license under French law and
|
||||||
* "http://www.cecill.info".
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
*
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
* modify and redistribute granted by the license, users are provided only
|
* "http://www.cecill.info".
|
||||||
* with a limited warranty and the software's author, the holder of the
|
*
|
||||||
* economic rights, and the successive licensors have only limited
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
* liability.
|
* modify and redistribute granted by the license, users are provided only
|
||||||
*
|
* with a limited warranty and the software's author, the holder of the
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
* economic rights, and the successive licensors have only limited
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
* liability.
|
||||||
* software by the user in light of its specific status of free software,
|
*
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
* therefore means that it is reserved for developers and experienced
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
* software by the user in light of its specific status of free software,
|
||||||
* encouraged to load and test the software's suitability as regards their
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
* therefore means that it is reserved for developers and experienced
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
* same conditions as regards security.
|
* encouraged to load and test the software's suitability as regards their
|
||||||
*
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
* The fact that you are presently reading this means that you have had
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
* same conditions as regards security.
|
||||||
*/
|
*
|
||||||
/**
|
* The fact that you are presently reading this means that you have had
|
||||||
* gclc:fr.bigeon.gclc.exception.InvalidCommandName.java
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
* Created on: Dec 23, 2014
|
* #L%
|
||||||
*/
|
*/
|
||||||
package fr.bigeon.gclc.exception;
|
|
||||||
|
|
||||||
/** <p>
|
|
||||||
* Exception sent from the application when a command is added but the name of
|
|
||||||
* the command
|
|
||||||
*
|
|
||||||
* @author Emmanuel BIGEON */
|
|
||||||
public class InvalidCommandName extends Exception {
|
|
||||||
|
|
||||||
/**
|
|
||||||
*
|
|
||||||
*/
|
|
||||||
private static final long serialVersionUID = 1L;
|
|
||||||
|
|
||||||
}
|
|
||||||
44
gclc-swt/src/site/site.xml
Normal file
44
gclc-swt/src/site/site.xml
Normal file
@@ -0,0 +1,44 @@
|
|||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<!--
|
||||||
|
#%L
|
||||||
|
Generic Command Ligne console
|
||||||
|
%%
|
||||||
|
Copyright (C) 2014 - 2018 Bigeon
|
||||||
|
%%
|
||||||
|
This software is governed by the CeCILL license under French law and
|
||||||
|
abiding by the rules of distribution of free software. You can use,
|
||||||
|
modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
"http://www.cecill.info".
|
||||||
|
|
||||||
|
As a counterpart to the access to the source code and rights to copy,
|
||||||
|
modify and redistribute granted by the license, users are provided only
|
||||||
|
with a limited warranty and the software's author, the holder of the
|
||||||
|
economic rights, and the successive licensors have only limited
|
||||||
|
liability.
|
||||||
|
|
||||||
|
In this respect, the user's attention is drawn to the risks associated
|
||||||
|
with loading, using, modifying and/or developing or reproducing the
|
||||||
|
software by the user in light of its specific status of free software,
|
||||||
|
that may mean that it is complicated to manipulate, and that also
|
||||||
|
therefore means that it is reserved for developers and experienced
|
||||||
|
professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
encouraged to load and test the software's suitability as regards their
|
||||||
|
requirements in conditions enabling the security of their systems and/or
|
||||||
|
data to be ensured and, more generally, to use and operate it in the
|
||||||
|
same conditions as regards security.
|
||||||
|
|
||||||
|
The fact that you are presently reading this means that you have had
|
||||||
|
knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
#L%
|
||||||
|
-->
|
||||||
|
|
||||||
|
<project name="GCLC">
|
||||||
|
<bannerRight>
|
||||||
|
<src>https://bigeon.net/images/logo_48.png</src>
|
||||||
|
<href>https://bigeon.net/</href>
|
||||||
|
</bannerRight>
|
||||||
|
<body>
|
||||||
|
<menu ref="reports"/>
|
||||||
|
</body>
|
||||||
|
</project>
|
||||||
@@ -0,0 +1,142 @@
|
|||||||
|
/*
|
||||||
|
* GCLC swt, provide a swt window for console applications
|
||||||
|
* Copyright (C) 2015-2017 E. Bigeon
|
||||||
|
* mailto:emmanuel@bigeon.fr
|
||||||
|
*
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
*/
|
||||||
|
/**
|
||||||
|
* gclc-swt:net.bigeon.gclc.swt.HistoryTextKeyListenerTest.java
|
||||||
|
* Created on: Nov 19, 2016
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.swt;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* GCLC swt
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2015 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import static org.junit.Assert.assertEquals;
|
||||||
|
|
||||||
|
import org.eclipse.swt.SWT;
|
||||||
|
import org.junit.Test;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* <p>
|
||||||
|
* TODO
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public class HistoryTextKeyListenerTest {
|
||||||
|
|
||||||
|
/** Test method for
|
||||||
|
* {@link net.bigeon.gclc.swt.HistoryTextKeyListener#keyPressed(org.eclipse.swt.events.KeyEvent)}. */
|
||||||
|
@Test
|
||||||
|
public final void testKeyPressedKeyEvent() {
|
||||||
|
ConsoleDelayIO io = new ConsoleDelayIO() {
|
||||||
|
private String input = "";
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public String getInput() {
|
||||||
|
return input;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void setInput(String input) {
|
||||||
|
this.input = input;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void validateInput() {
|
||||||
|
input = "";
|
||||||
|
}
|
||||||
|
};
|
||||||
|
HistoryTextKeyListener listener = new HistoryTextKeyListener(io);
|
||||||
|
|
||||||
|
// no effects
|
||||||
|
assertEquals("", io.getInput());
|
||||||
|
listener.pressedKeyCode(SWT.ARROW_UP);
|
||||||
|
assertEquals("", io.getInput());
|
||||||
|
listener.pressedKeyCode(SWT.ARROW_DOWN);
|
||||||
|
assertEquals("", io.getInput());
|
||||||
|
listener.pressedKeyCode('\r');
|
||||||
|
assertEquals("", io.getInput());
|
||||||
|
|
||||||
|
io.setInput("cmd arg");
|
||||||
|
listener.pressedKeyCode(SWT.ARROW_UP);
|
||||||
|
assertEquals("cmd arg", io.getInput());
|
||||||
|
listener.pressedKeyCode(SWT.ARROW_DOWN);
|
||||||
|
assertEquals("cmd arg", io.getInput());
|
||||||
|
listener.pressedKeyCode('\r');
|
||||||
|
assertEquals("", io.getInput());
|
||||||
|
|
||||||
|
io.setInput("cmd arg2");
|
||||||
|
listener.pressedKeyCode(SWT.ARROW_UP);
|
||||||
|
assertEquals("cmd arg", io.getInput());
|
||||||
|
listener.pressedKeyCode(SWT.ARROW_DOWN);
|
||||||
|
assertEquals("", io.getInput());
|
||||||
|
io.setInput("cmd arg2");
|
||||||
|
listener.pressedKeyCode('\r');
|
||||||
|
assertEquals("", io.getInput());
|
||||||
|
listener.pressedKeyCode(SWT.ARROW_UP);
|
||||||
|
assertEquals("cmd arg2", io.getInput());
|
||||||
|
listener.pressedKeyCode(SWT.ARROW_UP);
|
||||||
|
assertEquals("cmd arg", io.getInput());
|
||||||
|
listener.pressedKeyCode(SWT.ARROW_UP);
|
||||||
|
assertEquals("cmd arg", io.getInput());
|
||||||
|
listener.pressedKeyCode(SWT.ARROW_DOWN);
|
||||||
|
assertEquals("cmd arg2", io.getInput());
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
@@ -1,276 +1,366 @@
|
|||||||
/*
|
/*
|
||||||
* Copyright E. Bigeon (2015)
|
* GCLC swt, provide a swt window for console applications
|
||||||
*
|
* Copyright (C) 2015-2017 E. Bigeon
|
||||||
* emmanuel@bigeon.fr
|
* mailto:emmanuel@bigeon.fr
|
||||||
*
|
*
|
||||||
* This software is a computer program whose purpose is to
|
* This software is governed by the CeCILL license under French law and
|
||||||
* provide a swt window for console applications.
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
*
|
* modify and/or redistribute the software under the terms of the CeCILL
|
||||||
* This software is governed by the CeCILL license under French law and
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
* "http://www.cecill.info".
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
*
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
* "http://www.cecill.info".
|
* modify and redistribute granted by the license, users are provided only
|
||||||
*
|
* with a limited warranty and the software's author, the holder of the
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
* economic rights, and the successive licensors have only limited
|
||||||
* modify and redistribute granted by the license, users are provided only
|
* liability.
|
||||||
* with a limited warranty and the software's author, the holder of the
|
*
|
||||||
* economic rights, and the successive licensors have only limited
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
* liability.
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
*
|
* software by the user in light of its specific status of free software,
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
* therefore means that it is reserved for developers and experienced
|
||||||
* software by the user in light of its specific status of free software,
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
* encouraged to load and test the software's suitability as regards their
|
||||||
* therefore means that it is reserved for developers and experienced
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
* encouraged to load and test the software's suitability as regards their
|
* same conditions as regards security.
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
*
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
* The fact that you are presently reading this means that you have had
|
||||||
* same conditions as regards security.
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
*
|
*/
|
||||||
* The fact that you are presently reading this means that you have had
|
/**
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
* gclc-swt:net.bigeon.gclc.swt.SWTConsoleShellTest.java
|
||||||
*/
|
* Created on: Jun 8, 2016
|
||||||
/**
|
*/
|
||||||
* gclc-swt:fr.bigeon.gclc.swt.SWTConsoleShellTest.java
|
package net.bigeon.gclc.swt;
|
||||||
* Created on: Jun 8, 2016
|
|
||||||
*/
|
/*-
|
||||||
package fr.bigeon.gclc.swt;
|
* #%L
|
||||||
|
* GCLC swt
|
||||||
import static org.junit.Assert.assertFalse;
|
* %%
|
||||||
import static org.junit.Assert.assertTrue;
|
* Copyright (C) 2015 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
import java.io.IOException;
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
import org.eclipse.swt.widgets.Display;
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
import org.junit.Test;
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
import fr.bigeon.gclc.ConsoleApplication;
|
*
|
||||||
import fr.bigeon.gclc.command.Command;
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
import fr.bigeon.gclc.exception.CommandRunException;
|
* modify and redistribute granted by the license, users are provided only
|
||||||
import fr.bigeon.gclc.exception.InvalidCommandName;
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
/** <p>
|
* liability.
|
||||||
* TODO
|
*
|
||||||
*
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
* @author Emmanuel Bigeon */
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
public class SWTConsoleShellTest {
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
protected static final long TWO_SECONDS = 2000;
|
* therefore means that it is reserved for developers and experienced
|
||||||
private static final Display DISPLAY = new Display();
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
@Test
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
public void testConsoleClose() {
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
final SWTConsoleShell shell = new SWTConsoleShell(DISPLAY);
|
* same conditions as regards security.
|
||||||
final SWTConsole swtConsole = (SWTConsole) shell.getManager();
|
*
|
||||||
swtConsole.close();
|
* The fact that you are presently reading this means that you have had
|
||||||
swtConsole.setPrompt(":");
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
try {
|
* #L%
|
||||||
final ConsoleApplication appl = new ConsoleApplication(swtConsole,
|
*/
|
||||||
"exit", "Hello", "See you");
|
import static org.junit.Assert.assertFalse;
|
||||||
appl.add(new Command("long") {
|
import static org.junit.Assert.assertNotNull;
|
||||||
|
import static org.junit.Assert.assertTrue;
|
||||||
@Override
|
import static org.junit.Assert.fail;
|
||||||
public String tip() {
|
|
||||||
return "a long running command";
|
import java.io.IOException;
|
||||||
}
|
|
||||||
|
import org.eclipse.swt.SWT;
|
||||||
@Override
|
import org.eclipse.swt.widgets.Display;
|
||||||
public void execute(String... args) {
|
import org.junit.Test;
|
||||||
try {
|
|
||||||
Thread.sleep(TWO_SECONDS);
|
import net.bigeon.gclc.ConsoleApplication;
|
||||||
} catch (InterruptedException e) {
|
import net.bigeon.gclc.command.Command;
|
||||||
// TODO Auto-generated catch block
|
import net.bigeon.gclc.command.base.ExitCommand;
|
||||||
e.printStackTrace();
|
import net.bigeon.gclc.exception.CommandRunException;
|
||||||
}
|
import net.bigeon.gclc.exception.InvalidCommandName;
|
||||||
}
|
import net.bigeon.gclc.manager.ConsoleInput;
|
||||||
});
|
import net.bigeon.gclc.manager.ConsoleOutput;
|
||||||
appl.add(new Command("test") {
|
|
||||||
|
/**
|
||||||
@Override
|
* <p>
|
||||||
public String tip() {
|
* TODO
|
||||||
return "a prompting running command";
|
*
|
||||||
}
|
* @author Emmanuel Bigeon */
|
||||||
|
@SuppressWarnings({ "javadoc", "static-method", "nls", "deprecation" })
|
||||||
@Override
|
public class SWTConsoleShellTest {
|
||||||
public void execute(String... args) throws CommandRunException {
|
|
||||||
try {
|
protected static final long TWO_SECONDS = 2000;
|
||||||
appl.getManager().prompt("Test");
|
private static final Display DISPLAY = Display.getDefault();
|
||||||
} catch (IOException e) {
|
|
||||||
throw new CommandRunException("No input", e, this);
|
@Test
|
||||||
}
|
public void testGeneric() {
|
||||||
}
|
final SWTConsoleShell shell = new SWTConsoleShell(DISPLAY, SWT.SHELL_TRIM);
|
||||||
});
|
final SWTConsole swtConsole = shell.getManager();
|
||||||
// shell.pack();
|
try {
|
||||||
shell.open();
|
final ConsoleApplication appl = new ConsoleApplication(swtConsole, swtConsole,
|
||||||
Thread applThread = new Thread(new Runnable() {
|
"Hello", "See you");
|
||||||
|
appl.add(new ExitCommand("exit", appl));
|
||||||
@Override
|
appl.add(new Command("long") {
|
||||||
public void run() {
|
|
||||||
appl.start();
|
/* (non-Javadoc)
|
||||||
}
|
* @see fr.bigeon.gclc.command.ICommand#execute(fr.bigeon.gclc.
|
||||||
});
|
* manager.ConsoleOutput, fr.bigeon.gclc.manager.ConsoleInput,
|
||||||
Thread testThread = new Thread(new Runnable() {
|
* java.lang.String[]) */
|
||||||
|
@Override
|
||||||
@Override
|
public void execute(final ConsoleOutput out, final ConsoleInput in,
|
||||||
public void run() {
|
final String... args) throws CommandRunException {
|
||||||
try {
|
try {
|
||||||
Thread.sleep(TWO_SECONDS);
|
Thread.sleep(TWO_SECONDS);
|
||||||
} catch (InterruptedException e) {
|
} catch (final InterruptedException e) {
|
||||||
// TODO Auto-generated catch block
|
// TODO Auto-generated catch block
|
||||||
e.printStackTrace();
|
e.printStackTrace();
|
||||||
}
|
}
|
||||||
Display.getDefault().syncExec(new Runnable() {
|
}
|
||||||
@Override
|
|
||||||
public void run() {
|
@Override
|
||||||
swtConsole.setText("test"); //$NON-NLS-1$
|
public String tip() {
|
||||||
swtConsole.validateCommand();
|
return "a long running command";
|
||||||
}
|
}
|
||||||
});
|
|
||||||
Display.getDefault().syncExec(new Runnable() {
|
/* (non-Javadoc)
|
||||||
@Override
|
* @see fr.bigeon.gclc.command.Command#usageDetail() */
|
||||||
public void run() {
|
@Override
|
||||||
swtConsole.setText("ok"); //$NON-NLS-1$
|
protected String usageDetail() {
|
||||||
}
|
// TODO Auto-generated method stub
|
||||||
});
|
// return null;
|
||||||
swtConsole.validateCommand();
|
throw new RuntimeException("Not implemented yet");
|
||||||
Display.getDefault().syncExec(new Runnable() {
|
}
|
||||||
@Override
|
});
|
||||||
public void run() {
|
// shell.pack();
|
||||||
swtConsole.setText("long"); //$NON-NLS-1$
|
shell.open();
|
||||||
}
|
shell.setVisible(false);
|
||||||
});
|
final Thread applThread = new Thread(new Runnable() {
|
||||||
swtConsole.validateCommand();
|
|
||||||
Display.getDefault().syncExec(new Runnable() {
|
@Override
|
||||||
@Override
|
public void run() {
|
||||||
public void run() {
|
appl.start();
|
||||||
swtConsole.setText("test"); //$NON-NLS-1$
|
}
|
||||||
}
|
});
|
||||||
});
|
final Thread testThread = new Thread(new Runnable() {
|
||||||
swtConsole.validateCommand();
|
|
||||||
Display.getDefault().syncExec(new Runnable() {
|
@Override
|
||||||
@Override
|
public void run() {
|
||||||
public void run() {
|
try {
|
||||||
swtConsole.setText("test"); //$NON-NLS-1$
|
Thread.sleep(TWO_SECONDS);
|
||||||
}
|
} catch (final InterruptedException e) {
|
||||||
});
|
// TODO Auto-generated catch block
|
||||||
swtConsole.validateCommand();
|
e.printStackTrace();
|
||||||
try {
|
}
|
||||||
Thread.sleep(TWO_SECONDS);
|
Display.getDefault().syncExec(new Runnable() {
|
||||||
} catch (InterruptedException e) {
|
@Override
|
||||||
// TODO Auto-generated catch block
|
public void run() {
|
||||||
e.printStackTrace();
|
swtConsole.setText("test"); //$NON-NLS-1$
|
||||||
}
|
swtConsole.validateInput();
|
||||||
Display.getDefault().syncExec(new Runnable() {
|
}
|
||||||
@Override
|
});
|
||||||
public void run() {
|
try {
|
||||||
shell.dispose();
|
Thread.sleep(TWO_SECONDS);
|
||||||
}
|
} catch (final InterruptedException e) {
|
||||||
});
|
// TODO Auto-generated catch block
|
||||||
}
|
e.printStackTrace();
|
||||||
});
|
}
|
||||||
applThread.start();
|
Display.getDefault().syncExec(new Runnable() {
|
||||||
testThread.start();
|
@Override
|
||||||
while (!shell.isDisposed()) {
|
public void run() {
|
||||||
if (!DISPLAY.readAndDispatch()) {
|
shell.dispose();
|
||||||
DISPLAY.sleep();
|
}
|
||||||
}
|
});
|
||||||
}
|
}
|
||||||
// DISPLAY.dispose();
|
});
|
||||||
assertTrue(appl.getManager().isClosed());
|
applThread.start();
|
||||||
Thread.sleep(TWO_SECONDS);
|
testThread.start();
|
||||||
assertFalse(appl.isRunning());
|
while (!shell.isDisposed()) {
|
||||||
} catch (InvalidCommandName e) {
|
if (!DISPLAY.readAndDispatch()) {
|
||||||
// TODO Auto-generated catch block
|
DISPLAY.sleep();
|
||||||
e.printStackTrace();
|
}
|
||||||
} catch (InterruptedException e) {
|
}
|
||||||
// TODO Auto-generated catch block
|
// DISPLAY.dispose();
|
||||||
e.printStackTrace();
|
assertTrue(swtConsole.isClosed());
|
||||||
}
|
Thread.sleep(TWO_SECONDS);
|
||||||
}
|
assertFalse(appl.isRunning());
|
||||||
|
} catch (final InvalidCommandName e) {
|
||||||
@Test
|
// TODO Auto-generated catch block
|
||||||
public void test() {
|
e.printStackTrace();
|
||||||
final SWTConsoleShell shell = new SWTConsoleShell(DISPLAY);
|
} catch (final InterruptedException e) {
|
||||||
final SWTConsole swtConsole = (SWTConsole) shell.getManager();
|
// TODO Auto-generated catch block
|
||||||
try {
|
e.printStackTrace();
|
||||||
final ConsoleApplication appl = new ConsoleApplication(swtConsole,
|
}
|
||||||
"exit", "Hello", "See you");
|
}
|
||||||
appl.add(new Command("long") {
|
|
||||||
|
@Test
|
||||||
@Override
|
public void testConsoleClose() {
|
||||||
public String tip() {
|
final SWTConsoleShell shell = new SWTConsoleShell(DISPLAY, SWT.SHELL_TRIM);
|
||||||
return "a long running command";
|
final SWTConsole swtConsole = shell.getManager();
|
||||||
}
|
swtConsole.close();
|
||||||
|
swtConsole.setPrompt(":");
|
||||||
@Override
|
try {
|
||||||
public void execute(String... args) {
|
final ConsoleApplication appl = new ConsoleApplication(swtConsole, swtConsole,
|
||||||
try {
|
"Hello", "See you");
|
||||||
Thread.sleep(TWO_SECONDS);
|
appl.add(new ExitCommand("exit", appl));
|
||||||
} catch (InterruptedException e) {
|
appl.add(new Command("long") {
|
||||||
// TODO Auto-generated catch block
|
/* (non-Javadoc)
|
||||||
e.printStackTrace();
|
* @see fr.bigeon.gclc.command.ICommand#execute(fr.bigeon.gclc.
|
||||||
}
|
* manager.ConsoleOutput, fr.bigeon.gclc.manager.ConsoleInput,
|
||||||
}
|
* java.lang.String[]) */
|
||||||
});
|
@Override
|
||||||
// shell.pack();
|
public void execute(final ConsoleOutput out, final ConsoleInput in,
|
||||||
shell.open();
|
final String... args) throws CommandRunException {
|
||||||
Thread applThread = new Thread(new Runnable() {
|
try {
|
||||||
|
Thread.sleep(TWO_SECONDS);
|
||||||
@Override
|
} catch (final InterruptedException e) {
|
||||||
public void run() {
|
// TODO Auto-generated catch block
|
||||||
appl.start();
|
e.printStackTrace();
|
||||||
}
|
}
|
||||||
});
|
}
|
||||||
Thread testThread = new Thread(new Runnable() {
|
|
||||||
|
@Override
|
||||||
@Override
|
public String tip() {
|
||||||
public void run() {
|
return "a long running command";
|
||||||
try {
|
}
|
||||||
Thread.sleep(TWO_SECONDS);
|
|
||||||
} catch (InterruptedException e) {
|
/* (non-Javadoc)
|
||||||
// TODO Auto-generated catch block
|
* @see fr.bigeon.gclc.command.Command#usageDetail() */
|
||||||
e.printStackTrace();
|
@Override
|
||||||
}
|
protected String usageDetail() {
|
||||||
Display.getDefault().syncExec(new Runnable() {
|
// TODO Auto-generated method stub
|
||||||
@Override
|
// return null;
|
||||||
public void run() {
|
throw new RuntimeException("Not implemented yet");
|
||||||
swtConsole.setText("test"); //$NON-NLS-1$
|
}
|
||||||
swtConsole.validateCommand();
|
});
|
||||||
}
|
appl.add(new Command("test") {
|
||||||
});
|
/* (non-Javadoc)
|
||||||
try {
|
* @see fr.bigeon.gclc.command.ICommand#execute(fr.bigeon.gclc.
|
||||||
Thread.sleep(TWO_SECONDS);
|
* manager.ConsoleOutput, fr.bigeon.gclc.manager.ConsoleInput,
|
||||||
} catch (InterruptedException e) {
|
* java.lang.String[]) */
|
||||||
// TODO Auto-generated catch block
|
@Override
|
||||||
e.printStackTrace();
|
public void execute(final ConsoleOutput out, final ConsoleInput in,
|
||||||
}
|
final String... args) throws CommandRunException {
|
||||||
Display.getDefault().syncExec(new Runnable() {
|
try {
|
||||||
@Override
|
swtConsole.prompt("Test");
|
||||||
public void run() {
|
} catch (final IOException e) {
|
||||||
shell.dispose();
|
throw new CommandRunException("No input", e);
|
||||||
}
|
}
|
||||||
});
|
}
|
||||||
}
|
|
||||||
});
|
@Override
|
||||||
applThread.start();
|
public String tip() {
|
||||||
testThread.start();
|
return "a prompting running command";
|
||||||
while (!shell.isDisposed()) {
|
}
|
||||||
if (!DISPLAY.readAndDispatch()) {
|
|
||||||
DISPLAY.sleep();
|
/* (non-Javadoc)
|
||||||
}
|
* @see fr.bigeon.gclc.command.Command#usageDetail() */
|
||||||
}
|
@Override
|
||||||
// DISPLAY.dispose();
|
protected String usageDetail() {
|
||||||
assertTrue(appl.getManager().isClosed());
|
// TODO Auto-generated method stub
|
||||||
Thread.sleep(TWO_SECONDS);
|
// return null;
|
||||||
assertFalse(appl.isRunning());
|
throw new RuntimeException("Not implemented yet");
|
||||||
} catch (InvalidCommandName e) {
|
}
|
||||||
// TODO Auto-generated catch block
|
});
|
||||||
e.printStackTrace();
|
// shell.pack();
|
||||||
} catch (InterruptedException e) {
|
shell.open();
|
||||||
// TODO Auto-generated catch block
|
shell.setVisible(false);
|
||||||
e.printStackTrace();
|
final Thread applThread = new Thread(new Runnable() {
|
||||||
}
|
|
||||||
}
|
@Override
|
||||||
}
|
public void run() {
|
||||||
|
appl.start();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
final Thread testThread = new Thread(new Runnable() {
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
try {
|
||||||
|
Thread.sleep(TWO_SECONDS);
|
||||||
|
} catch (final InterruptedException e) {
|
||||||
|
// TODO Auto-generated catch block
|
||||||
|
e.printStackTrace();
|
||||||
|
}
|
||||||
|
Display.getDefault().syncExec(new Runnable() {
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
swtConsole.setText("test"); //$NON-NLS-1$
|
||||||
|
swtConsole.validateInput();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
Display.getDefault().syncExec(new Runnable() {
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
swtConsole.setText("ok"); //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
});
|
||||||
|
swtConsole.validateInput();
|
||||||
|
Display.getDefault().syncExec(new Runnable() {
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
swtConsole.setText("long"); //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
});
|
||||||
|
swtConsole.validateInput();
|
||||||
|
Display.getDefault().syncExec(new Runnable() {
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
swtConsole.setText("test"); //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
});
|
||||||
|
swtConsole.validateInput();
|
||||||
|
Display.getDefault().syncExec(new Runnable() {
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
swtConsole.setText("test"); //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
});
|
||||||
|
swtConsole.validateInput();
|
||||||
|
try {
|
||||||
|
Thread.sleep(TWO_SECONDS);
|
||||||
|
} catch (final InterruptedException e) {
|
||||||
|
// TODO Auto-generated catch block
|
||||||
|
e.printStackTrace();
|
||||||
|
}
|
||||||
|
Display.getDefault().syncExec(new Runnable() {
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
shell.dispose();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
}
|
||||||
|
});
|
||||||
|
applThread.start();
|
||||||
|
testThread.start();
|
||||||
|
while (!shell.isDisposed()) {
|
||||||
|
if (!DISPLAY.readAndDispatch()) {
|
||||||
|
DISPLAY.sleep();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
swtConsole.setPrompt(">");
|
||||||
|
try {
|
||||||
|
swtConsole.prompt();
|
||||||
|
fail("Prompting when closed should fail!");
|
||||||
|
} catch (final IOException e) {
|
||||||
|
assertNotNull(e);
|
||||||
|
}
|
||||||
|
// DISPLAY.dispose();
|
||||||
|
assertTrue(swtConsole.isClosed());
|
||||||
|
Thread.sleep(TWO_SECONDS);
|
||||||
|
assertFalse(appl.isRunning());
|
||||||
|
} catch (final InvalidCommandName e) {
|
||||||
|
// TODO Auto-generated catch block
|
||||||
|
e.printStackTrace();
|
||||||
|
} catch (final InterruptedException e) {
|
||||||
|
// TODO Auto-generated catch block
|
||||||
|
e.printStackTrace();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,204 @@
|
|||||||
|
/*
|
||||||
|
* GCLC swt, provide a swt window for console applications
|
||||||
|
* Copyright (C) 2015-2017 E. Bigeon
|
||||||
|
* mailto:emmanuel@bigeon.fr
|
||||||
|
*
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
*/
|
||||||
|
/**
|
||||||
|
* gclc-swt:net.bigeon.gclc.swt.SWTConsoleShellTest.java
|
||||||
|
* Created on: Jun 8, 2016
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.swt;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* GCLC swt
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2015 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import static org.junit.Assert.assertNull;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
|
||||||
|
import org.eclipse.swt.SWT;
|
||||||
|
import org.eclipse.swt.widgets.Display;
|
||||||
|
import org.eclipse.swt.widgets.Shell;
|
||||||
|
import org.junit.Test;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.ConsoleApplication;
|
||||||
|
import net.bigeon.gclc.command.Command;
|
||||||
|
import net.bigeon.gclc.command.base.ExitCommand;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunException;
|
||||||
|
import net.bigeon.gclc.exception.InvalidCommandName;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleInput;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleOutput;
|
||||||
|
import net.bigeon.gclc.utils.PipedConsoleInput;
|
||||||
|
import net.bigeon.gclc.utils.PipedConsoleOutput;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* <p>
|
||||||
|
* TODO
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
@SuppressWarnings({ "javadoc", "static-method", "nls", "deprecation" })
|
||||||
|
public class SWTConsoleViewTest {
|
||||||
|
|
||||||
|
protected static final long TWO_SECONDS = 2000;
|
||||||
|
private static final Display DISPLAY = Display.getDefault();
|
||||||
|
|
||||||
|
@Test
|
||||||
|
public void testGeneric() {
|
||||||
|
final Shell shell = new Shell(DISPLAY);
|
||||||
|
final SWTConsoleView swtConsole = new SWTConsoleView(shell, SWT.NONE);
|
||||||
|
try (PipedConsoleOutput manager = new PipedConsoleOutput();
|
||||||
|
PipedConsoleInput input = new PipedConsoleInput(System.out)) {
|
||||||
|
swtConsole.setManager(manager, input);
|
||||||
|
} catch (final IOException e2) {
|
||||||
|
assertNull(e2);
|
||||||
|
}
|
||||||
|
try (PipedConsoleOutput manager = new PipedConsoleOutput();
|
||||||
|
PipedConsoleInput input = new PipedConsoleInput(System.out)) {
|
||||||
|
swtConsole.setManager(manager, input);
|
||||||
|
final ConsoleApplication appl = new ConsoleApplication(manager, input,
|
||||||
|
"Hello", "See you");
|
||||||
|
appl.add(new ExitCommand("exit", appl));
|
||||||
|
appl.add(new Command("long") {
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.ICommand#execute(fr.bigeon.gclc.manager.
|
||||||
|
* ConsoleOutput, fr.bigeon.gclc.manager.ConsoleInput,
|
||||||
|
* java.lang.String[]) */
|
||||||
|
@Override
|
||||||
|
public void execute(final ConsoleOutput out, final ConsoleInput in,
|
||||||
|
final String... args) throws CommandRunException {
|
||||||
|
try {
|
||||||
|
Thread.sleep(TWO_SECONDS);
|
||||||
|
} catch (final InterruptedException e) {
|
||||||
|
// TODO Auto-generated catch block
|
||||||
|
e.printStackTrace();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public String tip() {
|
||||||
|
return "a long running command";
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.Command#usageDetail() */
|
||||||
|
@Override
|
||||||
|
protected String usageDetail() {
|
||||||
|
// TODO Auto-generated method stub
|
||||||
|
// return null;
|
||||||
|
throw new RuntimeException("Not implemented yet");
|
||||||
|
}
|
||||||
|
});
|
||||||
|
// shell.pack();
|
||||||
|
shell.open();
|
||||||
|
shell.setVisible(false);
|
||||||
|
final Thread applThread = new Thread(new Runnable() {
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
appl.start();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
final Thread testThread = new Thread(new Runnable() {
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
try {
|
||||||
|
Thread.sleep(TWO_SECONDS);
|
||||||
|
} catch (final InterruptedException e) {
|
||||||
|
// TODO Auto-generated catch block
|
||||||
|
e.printStackTrace();
|
||||||
|
}
|
||||||
|
Display.getDefault().syncExec(new Runnable() {
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
swtConsole.setText("test"); //$NON-NLS-1$
|
||||||
|
swtConsole.validateInput();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
try {
|
||||||
|
Thread.sleep(TWO_SECONDS);
|
||||||
|
} catch (final InterruptedException e) {
|
||||||
|
// TODO Auto-generated catch block
|
||||||
|
e.printStackTrace();
|
||||||
|
}
|
||||||
|
Display.getDefault().syncExec(new Runnable() {
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
shell.dispose();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
});
|
||||||
|
applThread.start();
|
||||||
|
testThread.start();
|
||||||
|
while (!shell.isDisposed()) {
|
||||||
|
if (!DISPLAY.readAndDispatch()) {
|
||||||
|
DISPLAY.sleep();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (final InvalidCommandName e) {
|
||||||
|
// TODO Auto-generated catch block
|
||||||
|
e.printStackTrace();
|
||||||
|
} catch (final IOException e1) {
|
||||||
|
// TODO Auto-generated catch block
|
||||||
|
e1.printStackTrace();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
4
gclc.system/.gitignore
vendored
Normal file
4
gclc.system/.gitignore
vendored
Normal file
@@ -0,0 +1,4 @@
|
|||||||
|
/target/
|
||||||
|
/.classpath
|
||||||
|
/.project
|
||||||
|
/.settings/
|
||||||
517
gclc.system/LICENSE.txt
Normal file
517
gclc.system/LICENSE.txt
Normal file
@@ -0,0 +1,517 @@
|
|||||||
|
CeCILL FREE SOFTWARE LICENSE AGREEMENT
|
||||||
|
|
||||||
|
Version 2.1 dated 2013-06-21
|
||||||
|
|
||||||
|
|
||||||
|
Notice
|
||||||
|
|
||||||
|
This Agreement is a Free Software license agreement that is the result
|
||||||
|
of discussions between its authors in order to ensure compliance with
|
||||||
|
the two main principles guiding its drafting:
|
||||||
|
|
||||||
|
* firstly, compliance with the principles governing the distribution
|
||||||
|
of Free Software: access to source code, broad rights granted to users,
|
||||||
|
* secondly, the election of a governing law, French law, with which it
|
||||||
|
is conformant, both as regards the law of torts and intellectual
|
||||||
|
property law, and the protection that it offers to both authors and
|
||||||
|
holders of the economic rights over software.
|
||||||
|
|
||||||
|
The authors of the CeCILL (for Ce[a] C[nrs] I[nria] L[ogiciel] L[ibre])
|
||||||
|
license are:
|
||||||
|
|
||||||
|
Commissariat à l'énergie atomique et aux énergies alternatives - CEA, a
|
||||||
|
public scientific, technical and industrial research establishment,
|
||||||
|
having its principal place of business at 25 rue Leblanc, immeuble Le
|
||||||
|
Ponant D, 75015 Paris, France.
|
||||||
|
|
||||||
|
Centre National de la Recherche Scientifique - CNRS, a public scientific
|
||||||
|
and technological establishment, having its principal place of business
|
||||||
|
at 3 rue Michel-Ange, 75794 Paris cedex 16, France.
|
||||||
|
|
||||||
|
Institut National de Recherche en Informatique et en Automatique -
|
||||||
|
Inria, a public scientific and technological establishment, having its
|
||||||
|
principal place of business at Domaine de Voluceau, Rocquencourt, BP
|
||||||
|
105, 78153 Le Chesnay cedex, France.
|
||||||
|
|
||||||
|
|
||||||
|
Preamble
|
||||||
|
|
||||||
|
The purpose of this Free Software license agreement is to grant users
|
||||||
|
the right to modify and redistribute the software governed by this
|
||||||
|
license within the framework of an open source distribution model.
|
||||||
|
|
||||||
|
The exercising of this right is conditional upon certain obligations for
|
||||||
|
users so as to preserve this status for all subsequent redistributions.
|
||||||
|
|
||||||
|
In consideration of access to the source code and the rights to copy,
|
||||||
|
modify and redistribute granted by the license, users are provided only
|
||||||
|
with a limited warranty and the software's author, the holder of the
|
||||||
|
economic rights, and the successive licensors only have limited liability.
|
||||||
|
|
||||||
|
In this respect, the risks associated with loading, using, modifying
|
||||||
|
and/or developing or reproducing the software by the user are brought to
|
||||||
|
the user's attention, given its Free Software status, which may make it
|
||||||
|
complicated to use, with the result that its use is reserved for
|
||||||
|
developers and experienced professionals having in-depth computer
|
||||||
|
knowledge. Users are therefore encouraged to load and test the
|
||||||
|
suitability of the software as regards their requirements in conditions
|
||||||
|
enabling the security of their systems and/or data to be ensured and,
|
||||||
|
more generally, to use and operate it in the same conditions of
|
||||||
|
security. This Agreement may be freely reproduced and published,
|
||||||
|
provided it is not altered, and that no provisions are either added or
|
||||||
|
removed herefrom.
|
||||||
|
|
||||||
|
This Agreement may apply to any or all software for which the holder of
|
||||||
|
the economic rights decides to submit the use thereof to its provisions.
|
||||||
|
|
||||||
|
Frequently asked questions can be found on the official website of the
|
||||||
|
CeCILL licenses family (http://www.cecill.info/index.en.html) for any
|
||||||
|
necessary clarification.
|
||||||
|
|
||||||
|
|
||||||
|
Article 1 - DEFINITIONS
|
||||||
|
|
||||||
|
For the purpose of this Agreement, when the following expressions
|
||||||
|
commence with a capital letter, they shall have the following meaning:
|
||||||
|
|
||||||
|
Agreement: means this license agreement, and its possible subsequent
|
||||||
|
versions and annexes.
|
||||||
|
|
||||||
|
Software: means the software in its Object Code and/or Source Code form
|
||||||
|
and, where applicable, its documentation, "as is" when the Licensee
|
||||||
|
accepts the Agreement.
|
||||||
|
|
||||||
|
Initial Software: means the Software in its Source Code and possibly its
|
||||||
|
Object Code form and, where applicable, its documentation, "as is" when
|
||||||
|
it is first distributed under the terms and conditions of the Agreement.
|
||||||
|
|
||||||
|
Modified Software: means the Software modified by at least one
|
||||||
|
Contribution.
|
||||||
|
|
||||||
|
Source Code: means all the Software's instructions and program lines to
|
||||||
|
which access is required so as to modify the Software.
|
||||||
|
|
||||||
|
Object Code: means the binary files originating from the compilation of
|
||||||
|
the Source Code.
|
||||||
|
|
||||||
|
Holder: means the holder(s) of the economic rights over the Initial
|
||||||
|
Software.
|
||||||
|
|
||||||
|
Licensee: means the Software user(s) having accepted the Agreement.
|
||||||
|
|
||||||
|
Contributor: means a Licensee having made at least one Contribution.
|
||||||
|
|
||||||
|
Licensor: means the Holder, or any other individual or legal entity, who
|
||||||
|
distributes the Software under the Agreement.
|
||||||
|
|
||||||
|
Contribution: means any or all modifications, corrections, translations,
|
||||||
|
adaptations and/or new functions integrated into the Software by any or
|
||||||
|
all Contributors, as well as any or all Internal Modules.
|
||||||
|
|
||||||
|
Module: means a set of sources files including their documentation that
|
||||||
|
enables supplementary functions or services in addition to those offered
|
||||||
|
by the Software.
|
||||||
|
|
||||||
|
External Module: means any or all Modules, not derived from the
|
||||||
|
Software, so that this Module and the Software run in separate address
|
||||||
|
spaces, with one calling the other when they are run.
|
||||||
|
|
||||||
|
Internal Module: means any or all Module, connected to the Software so
|
||||||
|
that they both execute in the same address space.
|
||||||
|
|
||||||
|
GNU GPL: means the GNU General Public License version 2 or any
|
||||||
|
subsequent version, as published by the Free Software Foundation Inc.
|
||||||
|
|
||||||
|
GNU Affero GPL: means the GNU Affero General Public License version 3 or
|
||||||
|
any subsequent version, as published by the Free Software Foundation Inc.
|
||||||
|
|
||||||
|
EUPL: means the European Union Public License version 1.1 or any
|
||||||
|
subsequent version, as published by the European Commission.
|
||||||
|
|
||||||
|
Parties: mean both the Licensee and the Licensor.
|
||||||
|
|
||||||
|
These expressions may be used both in singular and plural form.
|
||||||
|
|
||||||
|
|
||||||
|
Article 2 - PURPOSE
|
||||||
|
|
||||||
|
The purpose of the Agreement is the grant by the Licensor to the
|
||||||
|
Licensee of a non-exclusive, transferable and worldwide license for the
|
||||||
|
Software as set forth in Article 5 <#scope> hereinafter for the whole
|
||||||
|
term of the protection granted by the rights over said Software.
|
||||||
|
|
||||||
|
|
||||||
|
Article 3 - ACCEPTANCE
|
||||||
|
|
||||||
|
3.1 The Licensee shall be deemed as having accepted the terms and
|
||||||
|
conditions of this Agreement upon the occurrence of the first of the
|
||||||
|
following events:
|
||||||
|
|
||||||
|
* (i) loading the Software by any or all means, notably, by
|
||||||
|
downloading from a remote server, or by loading from a physical medium;
|
||||||
|
* (ii) the first time the Licensee exercises any of the rights granted
|
||||||
|
hereunder.
|
||||||
|
|
||||||
|
3.2 One copy of the Agreement, containing a notice relating to the
|
||||||
|
characteristics of the Software, to the limited warranty, and to the
|
||||||
|
fact that its use is restricted to experienced users has been provided
|
||||||
|
to the Licensee prior to its acceptance as set forth in Article 3.1
|
||||||
|
<#accepting> hereinabove, and the Licensee hereby acknowledges that it
|
||||||
|
has read and understood it.
|
||||||
|
|
||||||
|
|
||||||
|
Article 4 - EFFECTIVE DATE AND TERM
|
||||||
|
|
||||||
|
|
||||||
|
4.1 EFFECTIVE DATE
|
||||||
|
|
||||||
|
The Agreement shall become effective on the date when it is accepted by
|
||||||
|
the Licensee as set forth in Article 3.1 <#accepting>.
|
||||||
|
|
||||||
|
|
||||||
|
4.2 TERM
|
||||||
|
|
||||||
|
The Agreement shall remain in force for the entire legal term of
|
||||||
|
protection of the economic rights over the Software.
|
||||||
|
|
||||||
|
|
||||||
|
Article 5 - SCOPE OF RIGHTS GRANTED
|
||||||
|
|
||||||
|
The Licensor hereby grants to the Licensee, who accepts, the following
|
||||||
|
rights over the Software for any or all use, and for the term of the
|
||||||
|
Agreement, on the basis of the terms and conditions set forth hereinafter.
|
||||||
|
|
||||||
|
Besides, if the Licensor owns or comes to own one or more patents
|
||||||
|
protecting all or part of the functions of the Software or of its
|
||||||
|
components, the Licensor undertakes not to enforce the rights granted by
|
||||||
|
these patents against successive Licensees using, exploiting or
|
||||||
|
modifying the Software. If these patents are transferred, the Licensor
|
||||||
|
undertakes to have the transferees subscribe to the obligations set
|
||||||
|
forth in this paragraph.
|
||||||
|
|
||||||
|
|
||||||
|
5.1 RIGHT OF USE
|
||||||
|
|
||||||
|
The Licensee is authorized to use the Software, without any limitation
|
||||||
|
as to its fields of application, with it being hereinafter specified
|
||||||
|
that this comprises:
|
||||||
|
|
||||||
|
1. permanent or temporary reproduction of all or part of the Software
|
||||||
|
by any or all means and in any or all form.
|
||||||
|
|
||||||
|
2. loading, displaying, running, or storing the Software on any or all
|
||||||
|
medium.
|
||||||
|
|
||||||
|
3. entitlement to observe, study or test its operation so as to
|
||||||
|
determine the ideas and principles behind any or all constituent
|
||||||
|
elements of said Software. This shall apply when the Licensee
|
||||||
|
carries out any or all loading, displaying, running, transmission or
|
||||||
|
storage operation as regards the Software, that it is entitled to
|
||||||
|
carry out hereunder.
|
||||||
|
|
||||||
|
|
||||||
|
5.2 ENTITLEMENT TO MAKE CONTRIBUTIONS
|
||||||
|
|
||||||
|
The right to make Contributions includes the right to translate, adapt,
|
||||||
|
arrange, or make any or all modifications to the Software, and the right
|
||||||
|
to reproduce the resulting software.
|
||||||
|
|
||||||
|
The Licensee is authorized to make any or all Contributions to the
|
||||||
|
Software provided that it includes an explicit notice that it is the
|
||||||
|
author of said Contribution and indicates the date of the creation thereof.
|
||||||
|
|
||||||
|
|
||||||
|
5.3 RIGHT OF DISTRIBUTION
|
||||||
|
|
||||||
|
In particular, the right of distribution includes the right to publish,
|
||||||
|
transmit and communicate the Software to the general public on any or
|
||||||
|
all medium, and by any or all means, and the right to market, either in
|
||||||
|
consideration of a fee, or free of charge, one or more copies of the
|
||||||
|
Software by any means.
|
||||||
|
|
||||||
|
The Licensee is further authorized to distribute copies of the modified
|
||||||
|
or unmodified Software to third parties according to the terms and
|
||||||
|
conditions set forth hereinafter.
|
||||||
|
|
||||||
|
|
||||||
|
5.3.1 DISTRIBUTION OF SOFTWARE WITHOUT MODIFICATION
|
||||||
|
|
||||||
|
The Licensee is authorized to distribute true copies of the Software in
|
||||||
|
Source Code or Object Code form, provided that said distribution
|
||||||
|
complies with all the provisions of the Agreement and is accompanied by:
|
||||||
|
|
||||||
|
1. a copy of the Agreement,
|
||||||
|
|
||||||
|
2. a notice relating to the limitation of both the Licensor's warranty
|
||||||
|
and liability as set forth in Articles 8 and 9,
|
||||||
|
|
||||||
|
and that, in the event that only the Object Code of the Software is
|
||||||
|
redistributed, the Licensee allows effective access to the full Source
|
||||||
|
Code of the Software for a period of at least three years from the
|
||||||
|
distribution of the Software, it being understood that the additional
|
||||||
|
acquisition cost of the Source Code shall not exceed the cost of the
|
||||||
|
data transfer.
|
||||||
|
|
||||||
|
|
||||||
|
5.3.2 DISTRIBUTION OF MODIFIED SOFTWARE
|
||||||
|
|
||||||
|
When the Licensee makes a Contribution to the Software, the terms and
|
||||||
|
conditions for the distribution of the resulting Modified Software
|
||||||
|
become subject to all the provisions of this Agreement.
|
||||||
|
|
||||||
|
The Licensee is authorized to distribute the Modified Software, in
|
||||||
|
source code or object code form, provided that said distribution
|
||||||
|
complies with all the provisions of the Agreement and is accompanied by:
|
||||||
|
|
||||||
|
1. a copy of the Agreement,
|
||||||
|
|
||||||
|
2. a notice relating to the limitation of both the Licensor's warranty
|
||||||
|
and liability as set forth in Articles 8 and 9,
|
||||||
|
|
||||||
|
and, in the event that only the object code of the Modified Software is
|
||||||
|
redistributed,
|
||||||
|
|
||||||
|
3. a note stating the conditions of effective access to the full source
|
||||||
|
code of the Modified Software for a period of at least three years
|
||||||
|
from the distribution of the Modified Software, it being understood
|
||||||
|
that the additional acquisition cost of the source code shall not
|
||||||
|
exceed the cost of the data transfer.
|
||||||
|
|
||||||
|
|
||||||
|
5.3.3 DISTRIBUTION OF EXTERNAL MODULES
|
||||||
|
|
||||||
|
When the Licensee has developed an External Module, the terms and
|
||||||
|
conditions of this Agreement do not apply to said External Module, that
|
||||||
|
may be distributed under a separate license agreement.
|
||||||
|
|
||||||
|
|
||||||
|
5.3.4 COMPATIBILITY WITH OTHER LICENSES
|
||||||
|
|
||||||
|
The Licensee can include a code that is subject to the provisions of one
|
||||||
|
of the versions of the GNU GPL, GNU Affero GPL and/or EUPL in the
|
||||||
|
Modified or unmodified Software, and distribute that entire code under
|
||||||
|
the terms of the same version of the GNU GPL, GNU Affero GPL and/or EUPL.
|
||||||
|
|
||||||
|
The Licensee can include the Modified or unmodified Software in a code
|
||||||
|
that is subject to the provisions of one of the versions of the GNU GPL,
|
||||||
|
GNU Affero GPL and/or EUPL and distribute that entire code under the
|
||||||
|
terms of the same version of the GNU GPL, GNU Affero GPL and/or EUPL.
|
||||||
|
|
||||||
|
|
||||||
|
Article 6 - INTELLECTUAL PROPERTY
|
||||||
|
|
||||||
|
|
||||||
|
6.1 OVER THE INITIAL SOFTWARE
|
||||||
|
|
||||||
|
The Holder owns the economic rights over the Initial Software. Any or
|
||||||
|
all use of the Initial Software is subject to compliance with the terms
|
||||||
|
and conditions under which the Holder has elected to distribute its work
|
||||||
|
and no one shall be entitled to modify the terms and conditions for the
|
||||||
|
distribution of said Initial Software.
|
||||||
|
|
||||||
|
The Holder undertakes that the Initial Software will remain ruled at
|
||||||
|
least by this Agreement, for the duration set forth in Article 4.2 <#term>.
|
||||||
|
|
||||||
|
|
||||||
|
6.2 OVER THE CONTRIBUTIONS
|
||||||
|
|
||||||
|
The Licensee who develops a Contribution is the owner of the
|
||||||
|
intellectual property rights over this Contribution as defined by
|
||||||
|
applicable law.
|
||||||
|
|
||||||
|
|
||||||
|
6.3 OVER THE EXTERNAL MODULES
|
||||||
|
|
||||||
|
The Licensee who develops an External Module is the owner of the
|
||||||
|
intellectual property rights over this External Module as defined by
|
||||||
|
applicable law and is free to choose the type of agreement that shall
|
||||||
|
govern its distribution.
|
||||||
|
|
||||||
|
|
||||||
|
6.4 JOINT PROVISIONS
|
||||||
|
|
||||||
|
The Licensee expressly undertakes:
|
||||||
|
|
||||||
|
1. not to remove, or modify, in any manner, the intellectual property
|
||||||
|
notices attached to the Software;
|
||||||
|
|
||||||
|
2. to reproduce said notices, in an identical manner, in the copies of
|
||||||
|
the Software modified or not.
|
||||||
|
|
||||||
|
The Licensee undertakes not to directly or indirectly infringe the
|
||||||
|
intellectual property rights on the Software of the Holder and/or
|
||||||
|
Contributors, and to take, where applicable, vis-à-vis its staff, any
|
||||||
|
and all measures required to ensure respect of said intellectual
|
||||||
|
property rights of the Holder and/or Contributors.
|
||||||
|
|
||||||
|
|
||||||
|
Article 7 - RELATED SERVICES
|
||||||
|
|
||||||
|
7.1 Under no circumstances shall the Agreement oblige the Licensor to
|
||||||
|
provide technical assistance or maintenance services for the Software.
|
||||||
|
|
||||||
|
However, the Licensor is entitled to offer this type of services. The
|
||||||
|
terms and conditions of such technical assistance, and/or such
|
||||||
|
maintenance, shall be set forth in a separate instrument. Only the
|
||||||
|
Licensor offering said maintenance and/or technical assistance services
|
||||||
|
shall incur liability therefor.
|
||||||
|
|
||||||
|
7.2 Similarly, any Licensor is entitled to offer to its licensees, under
|
||||||
|
its sole responsibility, a warranty, that shall only be binding upon
|
||||||
|
itself, for the redistribution of the Software and/or the Modified
|
||||||
|
Software, under terms and conditions that it is free to decide. Said
|
||||||
|
warranty, and the financial terms and conditions of its application,
|
||||||
|
shall be subject of a separate instrument executed between the Licensor
|
||||||
|
and the Licensee.
|
||||||
|
|
||||||
|
|
||||||
|
Article 8 - LIABILITY
|
||||||
|
|
||||||
|
8.1 Subject to the provisions of Article 8.2, the Licensee shall be
|
||||||
|
entitled to claim compensation for any direct loss it may have suffered
|
||||||
|
from the Software as a result of a fault on the part of the relevant
|
||||||
|
Licensor, subject to providing evidence thereof.
|
||||||
|
|
||||||
|
8.2 The Licensor's liability is limited to the commitments made under
|
||||||
|
this Agreement and shall not be incurred as a result of in particular:
|
||||||
|
(i) loss due the Licensee's total or partial failure to fulfill its
|
||||||
|
obligations, (ii) direct or consequential loss that is suffered by the
|
||||||
|
Licensee due to the use or performance of the Software, and (iii) more
|
||||||
|
generally, any consequential loss. In particular the Parties expressly
|
||||||
|
agree that any or all pecuniary or business loss (i.e. loss of data,
|
||||||
|
loss of profits, operating loss, loss of customers or orders,
|
||||||
|
opportunity cost, any disturbance to business activities) or any or all
|
||||||
|
legal proceedings instituted against the Licensee by a third party,
|
||||||
|
shall constitute consequential loss and shall not provide entitlement to
|
||||||
|
any or all compensation from the Licensor.
|
||||||
|
|
||||||
|
|
||||||
|
Article 9 - WARRANTY
|
||||||
|
|
||||||
|
9.1 The Licensee acknowledges that the scientific and technical
|
||||||
|
state-of-the-art when the Software was distributed did not enable all
|
||||||
|
possible uses to be tested and verified, nor for the presence of
|
||||||
|
possible defects to be detected. In this respect, the Licensee's
|
||||||
|
attention has been drawn to the risks associated with loading, using,
|
||||||
|
modifying and/or developing and reproducing the Software which are
|
||||||
|
reserved for experienced users.
|
||||||
|
|
||||||
|
The Licensee shall be responsible for verifying, by any or all means,
|
||||||
|
the suitability of the product for its requirements, its good working
|
||||||
|
order, and for ensuring that it shall not cause damage to either persons
|
||||||
|
or properties.
|
||||||
|
|
||||||
|
9.2 The Licensor hereby represents, in good faith, that it is entitled
|
||||||
|
to grant all the rights over the Software (including in particular the
|
||||||
|
rights set forth in Article 5 <#scope>).
|
||||||
|
|
||||||
|
9.3 The Licensee acknowledges that the Software is supplied "as is" by
|
||||||
|
the Licensor without any other express or tacit warranty, other than
|
||||||
|
that provided for in Article 9.2 <#good-faith> and, in particular,
|
||||||
|
without any warranty as to its commercial value, its secured, safe,
|
||||||
|
innovative or relevant nature.
|
||||||
|
|
||||||
|
Specifically, the Licensor does not warrant that the Software is free
|
||||||
|
from any error, that it will operate without interruption, that it will
|
||||||
|
be compatible with the Licensee's own equipment and software
|
||||||
|
configuration, nor that it will meet the Licensee's requirements.
|
||||||
|
|
||||||
|
9.4 The Licensor does not either expressly or tacitly warrant that the
|
||||||
|
Software does not infringe any third party intellectual property right
|
||||||
|
relating to a patent, software or any other property right. Therefore,
|
||||||
|
the Licensor disclaims any and all liability towards the Licensee
|
||||||
|
arising out of any or all proceedings for infringement that may be
|
||||||
|
instituted in respect of the use, modification and redistribution of the
|
||||||
|
Software. Nevertheless, should such proceedings be instituted against
|
||||||
|
the Licensee, the Licensor shall provide it with technical and legal
|
||||||
|
expertise for its defense. Such technical and legal expertise shall be
|
||||||
|
decided on a case-by-case basis between the relevant Licensor and the
|
||||||
|
Licensee pursuant to a memorandum of understanding. The Licensor
|
||||||
|
disclaims any and all liability as regards the Licensee's use of the
|
||||||
|
name of the Software. No warranty is given as regards the existence of
|
||||||
|
prior rights over the name of the Software or as regards the existence
|
||||||
|
of a trademark.
|
||||||
|
|
||||||
|
|
||||||
|
Article 10 - TERMINATION
|
||||||
|
|
||||||
|
10.1 In the event of a breach by the Licensee of its obligations
|
||||||
|
hereunder, the Licensor may automatically terminate this Agreement
|
||||||
|
thirty (30) days after notice has been sent to the Licensee and has
|
||||||
|
remained ineffective.
|
||||||
|
|
||||||
|
10.2 A Licensee whose Agreement is terminated shall no longer be
|
||||||
|
authorized to use, modify or distribute the Software. However, any
|
||||||
|
licenses that it may have granted prior to termination of the Agreement
|
||||||
|
shall remain valid subject to their having been granted in compliance
|
||||||
|
with the terms and conditions hereof.
|
||||||
|
|
||||||
|
|
||||||
|
Article 11 - MISCELLANEOUS
|
||||||
|
|
||||||
|
|
||||||
|
11.1 EXCUSABLE EVENTS
|
||||||
|
|
||||||
|
Neither Party shall be liable for any or all delay, or failure to
|
||||||
|
perform the Agreement, that may be attributable to an event of force
|
||||||
|
majeure, an act of God or an outside cause, such as defective
|
||||||
|
functioning or interruptions of the electricity or telecommunications
|
||||||
|
networks, network paralysis following a virus attack, intervention by
|
||||||
|
government authorities, natural disasters, water damage, earthquakes,
|
||||||
|
fire, explosions, strikes and labor unrest, war, etc.
|
||||||
|
|
||||||
|
11.2 Any failure by either Party, on one or more occasions, to invoke
|
||||||
|
one or more of the provisions hereof, shall under no circumstances be
|
||||||
|
interpreted as being a waiver by the interested Party of its right to
|
||||||
|
invoke said provision(s) subsequently.
|
||||||
|
|
||||||
|
11.3 The Agreement cancels and replaces any or all previous agreements,
|
||||||
|
whether written or oral, between the Parties and having the same
|
||||||
|
purpose, and constitutes the entirety of the agreement between said
|
||||||
|
Parties concerning said purpose. No supplement or modification to the
|
||||||
|
terms and conditions hereof shall be effective as between the Parties
|
||||||
|
unless it is made in writing and signed by their duly authorized
|
||||||
|
representatives.
|
||||||
|
|
||||||
|
11.4 In the event that one or more of the provisions hereof were to
|
||||||
|
conflict with a current or future applicable act or legislative text,
|
||||||
|
said act or legislative text shall prevail, and the Parties shall make
|
||||||
|
the necessary amendments so as to comply with said act or legislative
|
||||||
|
text. All other provisions shall remain effective. Similarly, invalidity
|
||||||
|
of a provision of the Agreement, for any reason whatsoever, shall not
|
||||||
|
cause the Agreement as a whole to be invalid.
|
||||||
|
|
||||||
|
|
||||||
|
11.5 LANGUAGE
|
||||||
|
|
||||||
|
The Agreement is drafted in both French and English and both versions
|
||||||
|
are deemed authentic.
|
||||||
|
|
||||||
|
|
||||||
|
Article 12 - NEW VERSIONS OF THE AGREEMENT
|
||||||
|
|
||||||
|
12.1 Any person is authorized to duplicate and distribute copies of this
|
||||||
|
Agreement.
|
||||||
|
|
||||||
|
12.2 So as to ensure coherence, the wording of this Agreement is
|
||||||
|
protected and may only be modified by the authors of the License, who
|
||||||
|
reserve the right to periodically publish updates or new versions of the
|
||||||
|
Agreement, each with a separate number. These subsequent versions may
|
||||||
|
address new issues encountered by Free Software.
|
||||||
|
|
||||||
|
12.3 Any Software distributed under a given version of the Agreement may
|
||||||
|
only be subsequently distributed under the same version of the Agreement
|
||||||
|
or a subsequent version, subject to the provisions of Article 5.3.4
|
||||||
|
<#compatibility>.
|
||||||
|
|
||||||
|
|
||||||
|
Article 13 - GOVERNING LAW AND JURISDICTION
|
||||||
|
|
||||||
|
13.1 The Agreement is governed by French law. The Parties agree to
|
||||||
|
endeavor to seek an amicable solution to any disagreements or disputes
|
||||||
|
that may arise during the performance of the Agreement.
|
||||||
|
|
||||||
|
13.2 Failing an amicable solution within two (2) months as from their
|
||||||
|
occurrence, and unless emergency proceedings are necessary, the
|
||||||
|
disagreements or disputes shall be referred to the Paris Courts having
|
||||||
|
jurisdiction, by the more diligent Party.
|
||||||
73
gclc.system/pom.xml
Normal file
73
gclc.system/pom.xml
Normal file
@@ -0,0 +1,73 @@
|
|||||||
|
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
|
||||||
|
<modelVersion>4.0.0</modelVersion>
|
||||||
|
<parent>
|
||||||
|
<groupId>net.bigeon.config</groupId>
|
||||||
|
<artifactId>ebigeon-config</artifactId>
|
||||||
|
<version>1.8.21</version>
|
||||||
|
</parent>
|
||||||
|
<groupId>net.bigeon.gclc</groupId>
|
||||||
|
<artifactId>system</artifactId>
|
||||||
|
<version>0.0.3-SNAPSHOT</version>
|
||||||
|
<packaging>jar</packaging>
|
||||||
|
<name>GCLC system command</name>
|
||||||
|
<description>Provide an exec command to execute system commands</description>
|
||||||
|
<url>https://bigeon.net/projects/gclc.html</url>
|
||||||
|
<inceptionYear>2016</inceptionYear>
|
||||||
|
<organization>
|
||||||
|
<name>Bigeon</name>
|
||||||
|
<url>https://bigeon.net</url>
|
||||||
|
</organization>
|
||||||
|
<licenses>
|
||||||
|
<license>
|
||||||
|
<distribution>manual</distribution>
|
||||||
|
<name>CeCILL 2.1</name>
|
||||||
|
<url>https://cecill.info/licences/Licence_CeCILL_V2.1-en.html</url>
|
||||||
|
</license>
|
||||||
|
</licenses>
|
||||||
|
<developers>
|
||||||
|
<developer>
|
||||||
|
<email>emmanuel@bigeon.fr</email>
|
||||||
|
<name>Emmanuel Bigeon</name>
|
||||||
|
<url>bigeon.net</url>
|
||||||
|
<roles>
|
||||||
|
<role>PM</role>
|
||||||
|
</roles>
|
||||||
|
</developer>
|
||||||
|
</developers>
|
||||||
|
<scm>
|
||||||
|
<developerConnection>scm:git:gogs@git.code.bigeon.net:emmanuel/gclc.git</developerConnection>
|
||||||
|
<tag>HEAD</tag>
|
||||||
|
</scm>
|
||||||
|
<properties>
|
||||||
|
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
|
||||||
|
<copyright.email>emmanuel@bigeon.fr</copyright.email>
|
||||||
|
<license.licenseName>cecill_2.1</license.licenseName>
|
||||||
|
</properties>
|
||||||
|
|
||||||
|
<dependencies>
|
||||||
|
<dependency>
|
||||||
|
<groupId>net.bigeon</groupId>
|
||||||
|
<artifactId>gclc</artifactId>
|
||||||
|
<version>2.0.11</version>
|
||||||
|
</dependency>
|
||||||
|
</dependencies>
|
||||||
|
|
||||||
|
<build>
|
||||||
|
<plugins>
|
||||||
|
</plugins>
|
||||||
|
</build>
|
||||||
|
<reporting>
|
||||||
|
<plugins>
|
||||||
|
<plugin>
|
||||||
|
<groupId>org.apache.maven.plugins</groupId>
|
||||||
|
<artifactId>maven-javadoc-plugin</artifactId>
|
||||||
|
<version>2.10.3</version>
|
||||||
|
</plugin>
|
||||||
|
<plugin>
|
||||||
|
<groupId>com.github.sevntu-checkstyle</groupId>
|
||||||
|
<artifactId>dsm-maven-plugin</artifactId>
|
||||||
|
<version>2.2.0</version>
|
||||||
|
</plugin>
|
||||||
|
</plugins>
|
||||||
|
</reporting>
|
||||||
|
</project>
|
||||||
@@ -0,0 +1,140 @@
|
|||||||
|
/**
|
||||||
|
* gclc.system:net.bigeon.gclc.system.ExecSystemCommand.java
|
||||||
|
* Created on: Jun 20, 2016
|
||||||
|
*/
|
||||||
|
package net.bigeon.gclc.system;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* GCLC system command
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2016 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import java.io.BufferedWriter;
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.io.OutputStream;
|
||||||
|
import java.io.OutputStreamWriter;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.command.Command;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunException;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunExceptionType;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleInput;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleOutput;
|
||||||
|
|
||||||
|
/** A command that will execute system commands.
|
||||||
|
* <p>
|
||||||
|
* Note that this class may induce security issues in the code as it can execute
|
||||||
|
* arbitrary system commands. It is recommended that it be used only in private
|
||||||
|
* applications or application used by aware parties.
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public class ExecSystemCommand extends Command {
|
||||||
|
|
||||||
|
/** Error message for the manager closed. */
|
||||||
|
private static final String MANAGER_WAS_CLOSED = "manager was closed";
|
||||||
|
/** The command default name */
|
||||||
|
private static final String COMMAND_DEFAULT_NAME = "exec"; //$NON-NLS-1$
|
||||||
|
/** The end of line separator */
|
||||||
|
private static final String EOL = System.lineSeparator();
|
||||||
|
|
||||||
|
/** Create the command with the name 'exec'. */
|
||||||
|
public ExecSystemCommand() {
|
||||||
|
super(COMMAND_DEFAULT_NAME);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Create the command with a custom name.
|
||||||
|
*
|
||||||
|
* @param name the name of the command (the input from the manager that should
|
||||||
|
* trigger this command) */
|
||||||
|
public ExecSystemCommand(final String name) {
|
||||||
|
super(name);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.ICommand#execute(fr.bigeon.gclc.manager.
|
||||||
|
* ConsoleOutput, fr.bigeon.gclc.manager.ConsoleInput, java.lang.String[]) */
|
||||||
|
@Override
|
||||||
|
public void execute(final ConsoleOutput out, final ConsoleInput in,
|
||||||
|
final String... args) throws CommandRunException {
|
||||||
|
Process proc;
|
||||||
|
try {
|
||||||
|
proc = Runtime.getRuntime().exec(args);
|
||||||
|
} catch (final IOException e2) {
|
||||||
|
throw new CommandRunException("Unable to run process", e2);
|
||||||
|
}
|
||||||
|
// Stream forwarding to the application's console
|
||||||
|
// This is started in a parallel thread.
|
||||||
|
final Thread th = ForwardingRunnable.connect(proc.getInputStream(), out,
|
||||||
|
"Command output");
|
||||||
|
// Set the empty prompt for the processes promptings.
|
||||||
|
in.setPrompt(""); //$NON-NLS-1$
|
||||||
|
// Forward console input to the process, whether the process is waiting or not
|
||||||
|
// for input.
|
||||||
|
final OutputStream os = proc.getOutputStream();
|
||||||
|
try (BufferedWriter writer = new BufferedWriter(new OutputStreamWriter(os))) {
|
||||||
|
while (th.isAlive()) {
|
||||||
|
final String user = in.prompt();
|
||||||
|
// Avoid interruption being sent to process.
|
||||||
|
if (!user.isEmpty()) {
|
||||||
|
writer.write(user + EOL);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (final IOException e1) {
|
||||||
|
throw new CommandRunException(CommandRunExceptionType.INTERACTION,
|
||||||
|
MANAGER_WAS_CLOSED, e1); // $NON-NLS-1$
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.ICommand#tip() */
|
||||||
|
@Override
|
||||||
|
public String tip() {
|
||||||
|
return "Execute a system command"; //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.Command#usageDetail() */
|
||||||
|
@Override
|
||||||
|
protected String usageDetail() {
|
||||||
|
return " The system command is a system dependend command like sh on linux or" + //$NON-NLS-1$
|
||||||
|
System.lineSeparator() + "powershell on windows." + //$NON-NLS-1$
|
||||||
|
System.lineSeparator() + System.lineSeparator()
|
||||||
|
+ " As an example if you give \"cat\", \"/etc/hostname\" as arguments, on a linux" //$NON-NLS-1$
|
||||||
|
+ System.lineSeparator() + "system, you would get the computer name." + //$NON-NLS-1$
|
||||||
|
System.lineSeparator();
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see fr.bigeon.gclc.command.Command#usagePattern() */
|
||||||
|
@Override
|
||||||
|
protected String usagePattern() {
|
||||||
|
return " CMD <system command>"; //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,144 @@
|
|||||||
|
package net.bigeon.gclc.system;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* GCLC system command
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2016 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.io.InputStream;
|
||||||
|
import java.util.logging.Level;
|
||||||
|
import java.util.logging.Logger;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.exception.CommandRunException;
|
||||||
|
import net.bigeon.gclc.exception.CommandRunExceptionType;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleOutput;
|
||||||
|
|
||||||
|
/** A class forwarding the content of a stream into a console output.
|
||||||
|
* <p>
|
||||||
|
* This class is useful for processes that run in a different environment than
|
||||||
|
* the application but return an output. Such processes include command
|
||||||
|
* processes and socket communications for example.
|
||||||
|
* <p>
|
||||||
|
* In the current library is is used to retrieve a system command output.
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
public final class ForwardingRunnable implements Runnable {
|
||||||
|
/** Error message for the manager closed. */
|
||||||
|
private static final String MANAGER_WAS_CLOSED = "manager was closed";
|
||||||
|
/** The class logger */
|
||||||
|
private static final Logger LOGGER = Logger
|
||||||
|
.getLogger(ForwardingRunnable.class.getName());
|
||||||
|
|
||||||
|
/** The console output. */
|
||||||
|
private final ConsoleOutput out;
|
||||||
|
/** The input stream. */
|
||||||
|
private final InputStream is;
|
||||||
|
|
||||||
|
/** Create the runnable.
|
||||||
|
*
|
||||||
|
* @param out the output console
|
||||||
|
* @param is the input stream */
|
||||||
|
public ForwardingRunnable(final ConsoleOutput out, final InputStream is) {
|
||||||
|
this.out = out;
|
||||||
|
this.is = is;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* (non-Javadoc)
|
||||||
|
* @see java.lang.Runnable#run() */
|
||||||
|
@Override
|
||||||
|
public void run() {
|
||||||
|
try {
|
||||||
|
readToEnd(out, is);
|
||||||
|
is.close();
|
||||||
|
} catch (final CommandRunException e) {
|
||||||
|
LOGGER.log(Level.WARNING, "Manager was closed in the meantime...", e); //$NON-NLS-1$
|
||||||
|
} catch (final IOException e) {
|
||||||
|
LOGGER.log(Level.WARNING, "Input stream was closed...", e); //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Read the input until its end.
|
||||||
|
*
|
||||||
|
* @param is the input stream
|
||||||
|
* @throws CommandRunException if the manager was closed while writing the
|
||||||
|
* stream */
|
||||||
|
private static void readToEnd(final ConsoleOutput out, final InputStream is)
|
||||||
|
throws CommandRunException {
|
||||||
|
int c;
|
||||||
|
try {
|
||||||
|
while ((c = is.read()) >= 0) {
|
||||||
|
// Print the character in the output
|
||||||
|
printCharacter(out, (char) c);
|
||||||
|
}
|
||||||
|
} catch (final IOException e) {
|
||||||
|
LOGGER.log(Level.INFO, "input stream reading failed", e); //$NON-NLS-1$
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Print a character on the console.
|
||||||
|
*
|
||||||
|
* @param out the console
|
||||||
|
* @param c the character
|
||||||
|
* @throws CommandRunException if the console failed to print the character. */
|
||||||
|
private static void printCharacter(final ConsoleOutput out, final char c)
|
||||||
|
throws CommandRunException {
|
||||||
|
try {
|
||||||
|
out.print(Character.toString(c));
|
||||||
|
} catch (final IOException e) {
|
||||||
|
throw new CommandRunException(CommandRunExceptionType.INTERACTION,
|
||||||
|
MANAGER_WAS_CLOSED, e); // $NON-NLS-1$
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Tool method to connect an input stream to a console output.
|
||||||
|
*
|
||||||
|
* @param stream the stream
|
||||||
|
* @param output the output
|
||||||
|
* @param name the identification of the thread
|
||||||
|
* @return the thread the forwarding runnable runs into. */
|
||||||
|
public static Thread connect(final InputStream stream, final ConsoleOutput output,
|
||||||
|
final String name) {
|
||||||
|
final Thread th = new Thread(new ForwardingRunnable(output, stream), name);
|
||||||
|
th.start();
|
||||||
|
return th;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Tool method to connect an input stream to a console output.
|
||||||
|
*
|
||||||
|
* @param stream the stream
|
||||||
|
* @param output the output
|
||||||
|
* @return the thread the forwarding runnable runs into. */
|
||||||
|
public static Thread connect(final InputStream stream, final ConsoleOutput output) {
|
||||||
|
return connect(stream, output, "Forwarding");
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,42 @@
|
|||||||
|
/** This package contains classes for command execution on the system.
|
||||||
|
* <p>
|
||||||
|
* The class {@link net.bigeon.gclc.system.ExecSystemCommand} is, in the current
|
||||||
|
* version (0.0.1), a source of vulnerability and should probably be used only
|
||||||
|
* in private projects where the user is aware of the dangers.
|
||||||
|
*
|
||||||
|
* @author Emmanuel Bigeon */
|
||||||
|
package net.bigeon.gclc.system;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* GCLC system command
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2016 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
44
gclc.system/src/site/site.xml
Normal file
44
gclc.system/src/site/site.xml
Normal file
@@ -0,0 +1,44 @@
|
|||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<!--
|
||||||
|
#%L
|
||||||
|
Generic Command Ligne console
|
||||||
|
%%
|
||||||
|
Copyright (C) 2014 - 2018 Bigeon
|
||||||
|
%%
|
||||||
|
This software is governed by the CeCILL license under French law and
|
||||||
|
abiding by the rules of distribution of free software. You can use,
|
||||||
|
modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
"http://www.cecill.info".
|
||||||
|
|
||||||
|
As a counterpart to the access to the source code and rights to copy,
|
||||||
|
modify and redistribute granted by the license, users are provided only
|
||||||
|
with a limited warranty and the software's author, the holder of the
|
||||||
|
economic rights, and the successive licensors have only limited
|
||||||
|
liability.
|
||||||
|
|
||||||
|
In this respect, the user's attention is drawn to the risks associated
|
||||||
|
with loading, using, modifying and/or developing or reproducing the
|
||||||
|
software by the user in light of its specific status of free software,
|
||||||
|
that may mean that it is complicated to manipulate, and that also
|
||||||
|
therefore means that it is reserved for developers and experienced
|
||||||
|
professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
encouraged to load and test the software's suitability as regards their
|
||||||
|
requirements in conditions enabling the security of their systems and/or
|
||||||
|
data to be ensured and, more generally, to use and operate it in the
|
||||||
|
same conditions as regards security.
|
||||||
|
|
||||||
|
The fact that you are presently reading this means that you have had
|
||||||
|
knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
#L%
|
||||||
|
-->
|
||||||
|
|
||||||
|
<project name="GCLC">
|
||||||
|
<bannerRight>
|
||||||
|
<src>https://bigeon.net/images/logo_48.png</src>
|
||||||
|
<href>https://bigeon.net/</href>
|
||||||
|
</bannerRight>
|
||||||
|
<body>
|
||||||
|
<menu ref="reports"/>
|
||||||
|
</body>
|
||||||
|
</project>
|
||||||
@@ -0,0 +1,82 @@
|
|||||||
|
package net.bigeon.gclc.system;
|
||||||
|
|
||||||
|
/*-
|
||||||
|
* #%L
|
||||||
|
* GCLC system command
|
||||||
|
* %%
|
||||||
|
* Copyright (C) 2016 - 2018 Bigeon
|
||||||
|
* %%
|
||||||
|
* This software is governed by the CeCILL license under French law and
|
||||||
|
* abiding by the rules of distribution of free software. You can use,
|
||||||
|
* modify and/ or redistribute the software under the terms of the CeCILL
|
||||||
|
* license as circulated by CEA, CNRS and INRIA at the following URL
|
||||||
|
* "http://www.cecill.info".
|
||||||
|
*
|
||||||
|
* As a counterpart to the access to the source code and rights to copy,
|
||||||
|
* modify and redistribute granted by the license, users are provided only
|
||||||
|
* with a limited warranty and the software's author, the holder of the
|
||||||
|
* economic rights, and the successive licensors have only limited
|
||||||
|
* liability.
|
||||||
|
*
|
||||||
|
* In this respect, the user's attention is drawn to the risks associated
|
||||||
|
* with loading, using, modifying and/or developing or reproducing the
|
||||||
|
* software by the user in light of its specific status of free software,
|
||||||
|
* that may mean that it is complicated to manipulate, and that also
|
||||||
|
* therefore means that it is reserved for developers and experienced
|
||||||
|
* professionals having in-depth computer knowledge. Users are therefore
|
||||||
|
* encouraged to load and test the software's suitability as regards their
|
||||||
|
* requirements in conditions enabling the security of their systems and/or
|
||||||
|
* data to be ensured and, more generally, to use and operate it in the
|
||||||
|
* same conditions as regards security.
|
||||||
|
*
|
||||||
|
* The fact that you are presently reading this means that you have had
|
||||||
|
* knowledge of the CeCILL license and that you accept its terms.
|
||||||
|
* #L%
|
||||||
|
*/
|
||||||
|
import static org.junit.Assert.assertEquals;
|
||||||
|
import static org.junit.Assert.assertNotNull;
|
||||||
|
import static org.junit.Assert.fail;
|
||||||
|
|
||||||
|
import org.junit.Test;
|
||||||
|
|
||||||
|
import net.bigeon.gclc.exception.CommandRunException;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleInput;
|
||||||
|
import net.bigeon.gclc.manager.ConsoleOutput;
|
||||||
|
import net.bigeon.gclc.utils.EmptyInput;
|
||||||
|
import net.bigeon.gclc.utils.SinkOutput;
|
||||||
|
|
||||||
|
public class ExecSystemCommandTest {
|
||||||
|
|
||||||
|
/** Test the help methods of the command. */
|
||||||
|
@Test
|
||||||
|
public void testExecSystemCommand() {
|
||||||
|
final ExecSystemCommand cmd = new ExecSystemCommand("test");
|
||||||
|
assertEquals("Name should be preserved", "test", cmd.getCommandName());
|
||||||
|
assertNotNull("tip should be defined", cmd.tip());
|
||||||
|
assertNotNull("usage should be defined", cmd.usagePattern());
|
||||||
|
assertNotNull("usage should be defined", cmd.usageDetail());
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Test the execution of the command.
|
||||||
|
*
|
||||||
|
* @throws CommandRunException */
|
||||||
|
@Test
|
||||||
|
public void testExecute() throws CommandRunException {
|
||||||
|
final ConsoleOutput out = SinkOutput.INSTANCE;
|
||||||
|
final ConsoleInput in = EmptyInput.INSTANCE;
|
||||||
|
|
||||||
|
final ExecSystemCommand cmd = new ExecSystemCommand();
|
||||||
|
if (System.getProperty("os.name").contains("indows")) {
|
||||||
|
cmd.execute(out, in, "cmd", "/C", "dir");
|
||||||
|
} else if (System.getProperty("os.name").contains("inux")) {
|
||||||
|
cmd.execute(out, in, "ls");
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
cmd.execute(out, in, "inexistent");
|
||||||
|
fail("Able to execute inexistent command in system");
|
||||||
|
} catch (final CommandRunException e) {
|
||||||
|
// ok
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
517
gclc/LICENSE.txt
Normal file
517
gclc/LICENSE.txt
Normal file
@@ -0,0 +1,517 @@
|
|||||||
|
CeCILL FREE SOFTWARE LICENSE AGREEMENT
|
||||||
|
|
||||||
|
Version 2.1 dated 2013-06-21
|
||||||
|
|
||||||
|
|
||||||
|
Notice
|
||||||
|
|
||||||
|
This Agreement is a Free Software license agreement that is the result
|
||||||
|
of discussions between its authors in order to ensure compliance with
|
||||||
|
the two main principles guiding its drafting:
|
||||||
|
|
||||||
|
* firstly, compliance with the principles governing the distribution
|
||||||
|
of Free Software: access to source code, broad rights granted to users,
|
||||||
|
* secondly, the election of a governing law, French law, with which it
|
||||||
|
is conformant, both as regards the law of torts and intellectual
|
||||||
|
property law, and the protection that it offers to both authors and
|
||||||
|
holders of the economic rights over software.
|
||||||
|
|
||||||
|
The authors of the CeCILL (for Ce[a] C[nrs] I[nria] L[ogiciel] L[ibre])
|
||||||
|
license are:
|
||||||
|
|
||||||
|
Commissariat à l'énergie atomique et aux énergies alternatives - CEA, a
|
||||||
|
public scientific, technical and industrial research establishment,
|
||||||
|
having its principal place of business at 25 rue Leblanc, immeuble Le
|
||||||
|
Ponant D, 75015 Paris, France.
|
||||||
|
|
||||||
|
Centre National de la Recherche Scientifique - CNRS, a public scientific
|
||||||
|
and technological establishment, having its principal place of business
|
||||||
|
at 3 rue Michel-Ange, 75794 Paris cedex 16, France.
|
||||||
|
|
||||||
|
Institut National de Recherche en Informatique et en Automatique -
|
||||||
|
Inria, a public scientific and technological establishment, having its
|
||||||
|
principal place of business at Domaine de Voluceau, Rocquencourt, BP
|
||||||
|
105, 78153 Le Chesnay cedex, France.
|
||||||
|
|
||||||
|
|
||||||
|
Preamble
|
||||||
|
|
||||||
|
The purpose of this Free Software license agreement is to grant users
|
||||||
|
the right to modify and redistribute the software governed by this
|
||||||
|
license within the framework of an open source distribution model.
|
||||||
|
|
||||||
|
The exercising of this right is conditional upon certain obligations for
|
||||||
|
users so as to preserve this status for all subsequent redistributions.
|
||||||
|
|
||||||
|
In consideration of access to the source code and the rights to copy,
|
||||||
|
modify and redistribute granted by the license, users are provided only
|
||||||
|
with a limited warranty and the software's author, the holder of the
|
||||||
|
economic rights, and the successive licensors only have limited liability.
|
||||||
|
|
||||||
|
In this respect, the risks associated with loading, using, modifying
|
||||||
|
and/or developing or reproducing the software by the user are brought to
|
||||||
|
the user's attention, given its Free Software status, which may make it
|
||||||
|
complicated to use, with the result that its use is reserved for
|
||||||
|
developers and experienced professionals having in-depth computer
|
||||||
|
knowledge. Users are therefore encouraged to load and test the
|
||||||
|
suitability of the software as regards their requirements in conditions
|
||||||
|
enabling the security of their systems and/or data to be ensured and,
|
||||||
|
more generally, to use and operate it in the same conditions of
|
||||||
|
security. This Agreement may be freely reproduced and published,
|
||||||
|
provided it is not altered, and that no provisions are either added or
|
||||||
|
removed herefrom.
|
||||||
|
|
||||||
|
This Agreement may apply to any or all software for which the holder of
|
||||||
|
the economic rights decides to submit the use thereof to its provisions.
|
||||||
|
|
||||||
|
Frequently asked questions can be found on the official website of the
|
||||||
|
CeCILL licenses family (http://www.cecill.info/index.en.html) for any
|
||||||
|
necessary clarification.
|
||||||
|
|
||||||
|
|
||||||
|
Article 1 - DEFINITIONS
|
||||||
|
|
||||||
|
For the purpose of this Agreement, when the following expressions
|
||||||
|
commence with a capital letter, they shall have the following meaning:
|
||||||
|
|
||||||
|
Agreement: means this license agreement, and its possible subsequent
|
||||||
|
versions and annexes.
|
||||||
|
|
||||||
|
Software: means the software in its Object Code and/or Source Code form
|
||||||
|
and, where applicable, its documentation, "as is" when the Licensee
|
||||||
|
accepts the Agreement.
|
||||||
|
|
||||||
|
Initial Software: means the Software in its Source Code and possibly its
|
||||||
|
Object Code form and, where applicable, its documentation, "as is" when
|
||||||
|
it is first distributed under the terms and conditions of the Agreement.
|
||||||
|
|
||||||
|
Modified Software: means the Software modified by at least one
|
||||||
|
Contribution.
|
||||||
|
|
||||||
|
Source Code: means all the Software's instructions and program lines to
|
||||||
|
which access is required so as to modify the Software.
|
||||||
|
|
||||||
|
Object Code: means the binary files originating from the compilation of
|
||||||
|
the Source Code.
|
||||||
|
|
||||||
|
Holder: means the holder(s) of the economic rights over the Initial
|
||||||
|
Software.
|
||||||
|
|
||||||
|
Licensee: means the Software user(s) having accepted the Agreement.
|
||||||
|
|
||||||
|
Contributor: means a Licensee having made at least one Contribution.
|
||||||
|
|
||||||
|
Licensor: means the Holder, or any other individual or legal entity, who
|
||||||
|
distributes the Software under the Agreement.
|
||||||
|
|
||||||
|
Contribution: means any or all modifications, corrections, translations,
|
||||||
|
adaptations and/or new functions integrated into the Software by any or
|
||||||
|
all Contributors, as well as any or all Internal Modules.
|
||||||
|
|
||||||
|
Module: means a set of sources files including their documentation that
|
||||||
|
enables supplementary functions or services in addition to those offered
|
||||||
|
by the Software.
|
||||||
|
|
||||||
|
External Module: means any or all Modules, not derived from the
|
||||||
|
Software, so that this Module and the Software run in separate address
|
||||||
|
spaces, with one calling the other when they are run.
|
||||||
|
|
||||||
|
Internal Module: means any or all Module, connected to the Software so
|
||||||
|
that they both execute in the same address space.
|
||||||
|
|
||||||
|
GNU GPL: means the GNU General Public License version 2 or any
|
||||||
|
subsequent version, as published by the Free Software Foundation Inc.
|
||||||
|
|
||||||
|
GNU Affero GPL: means the GNU Affero General Public License version 3 or
|
||||||
|
any subsequent version, as published by the Free Software Foundation Inc.
|
||||||
|
|
||||||
|
EUPL: means the European Union Public License version 1.1 or any
|
||||||
|
subsequent version, as published by the European Commission.
|
||||||
|
|
||||||
|
Parties: mean both the Licensee and the Licensor.
|
||||||
|
|
||||||
|
These expressions may be used both in singular and plural form.
|
||||||
|
|
||||||
|
|
||||||
|
Article 2 - PURPOSE
|
||||||
|
|
||||||
|
The purpose of the Agreement is the grant by the Licensor to the
|
||||||
|
Licensee of a non-exclusive, transferable and worldwide license for the
|
||||||
|
Software as set forth in Article 5 <#scope> hereinafter for the whole
|
||||||
|
term of the protection granted by the rights over said Software.
|
||||||
|
|
||||||
|
|
||||||
|
Article 3 - ACCEPTANCE
|
||||||
|
|
||||||
|
3.1 The Licensee shall be deemed as having accepted the terms and
|
||||||
|
conditions of this Agreement upon the occurrence of the first of the
|
||||||
|
following events:
|
||||||
|
|
||||||
|
* (i) loading the Software by any or all means, notably, by
|
||||||
|
downloading from a remote server, or by loading from a physical medium;
|
||||||
|
* (ii) the first time the Licensee exercises any of the rights granted
|
||||||
|
hereunder.
|
||||||
|
|
||||||
|
3.2 One copy of the Agreement, containing a notice relating to the
|
||||||
|
characteristics of the Software, to the limited warranty, and to the
|
||||||
|
fact that its use is restricted to experienced users has been provided
|
||||||
|
to the Licensee prior to its acceptance as set forth in Article 3.1
|
||||||
|
<#accepting> hereinabove, and the Licensee hereby acknowledges that it
|
||||||
|
has read and understood it.
|
||||||
|
|
||||||
|
|
||||||
|
Article 4 - EFFECTIVE DATE AND TERM
|
||||||
|
|
||||||
|
|
||||||
|
4.1 EFFECTIVE DATE
|
||||||
|
|
||||||
|
The Agreement shall become effective on the date when it is accepted by
|
||||||
|
the Licensee as set forth in Article 3.1 <#accepting>.
|
||||||
|
|
||||||
|
|
||||||
|
4.2 TERM
|
||||||
|
|
||||||
|
The Agreement shall remain in force for the entire legal term of
|
||||||
|
protection of the economic rights over the Software.
|
||||||
|
|
||||||
|
|
||||||
|
Article 5 - SCOPE OF RIGHTS GRANTED
|
||||||
|
|
||||||
|
The Licensor hereby grants to the Licensee, who accepts, the following
|
||||||
|
rights over the Software for any or all use, and for the term of the
|
||||||
|
Agreement, on the basis of the terms and conditions set forth hereinafter.
|
||||||
|
|
||||||
|
Besides, if the Licensor owns or comes to own one or more patents
|
||||||
|
protecting all or part of the functions of the Software or of its
|
||||||
|
components, the Licensor undertakes not to enforce the rights granted by
|
||||||
|
these patents against successive Licensees using, exploiting or
|
||||||
|
modifying the Software. If these patents are transferred, the Licensor
|
||||||
|
undertakes to have the transferees subscribe to the obligations set
|
||||||
|
forth in this paragraph.
|
||||||
|
|
||||||
|
|
||||||
|
5.1 RIGHT OF USE
|
||||||
|
|
||||||
|
The Licensee is authorized to use the Software, without any limitation
|
||||||
|
as to its fields of application, with it being hereinafter specified
|
||||||
|
that this comprises:
|
||||||
|
|
||||||
|
1. permanent or temporary reproduction of all or part of the Software
|
||||||
|
by any or all means and in any or all form.
|
||||||
|
|
||||||
|
2. loading, displaying, running, or storing the Software on any or all
|
||||||
|
medium.
|
||||||
|
|
||||||
|
3. entitlement to observe, study or test its operation so as to
|
||||||
|
determine the ideas and principles behind any or all constituent
|
||||||
|
elements of said Software. This shall apply when the Licensee
|
||||||
|
carries out any or all loading, displaying, running, transmission or
|
||||||
|
storage operation as regards the Software, that it is entitled to
|
||||||
|
carry out hereunder.
|
||||||
|
|
||||||
|
|
||||||
|
5.2 ENTITLEMENT TO MAKE CONTRIBUTIONS
|
||||||
|
|
||||||
|
The right to make Contributions includes the right to translate, adapt,
|
||||||
|
arrange, or make any or all modifications to the Software, and the right
|
||||||
|
to reproduce the resulting software.
|
||||||
|
|
||||||
|
The Licensee is authorized to make any or all Contributions to the
|
||||||
|
Software provided that it includes an explicit notice that it is the
|
||||||
|
author of said Contribution and indicates the date of the creation thereof.
|
||||||
|
|
||||||
|
|
||||||
|
5.3 RIGHT OF DISTRIBUTION
|
||||||
|
|
||||||
|
In particular, the right of distribution includes the right to publish,
|
||||||
|
transmit and communicate the Software to the general public on any or
|
||||||
|
all medium, and by any or all means, and the right to market, either in
|
||||||
|
consideration of a fee, or free of charge, one or more copies of the
|
||||||
|
Software by any means.
|
||||||
|
|
||||||
|
The Licensee is further authorized to distribute copies of the modified
|
||||||
|
or unmodified Software to third parties according to the terms and
|
||||||
|
conditions set forth hereinafter.
|
||||||
|
|
||||||
|
|
||||||
|
5.3.1 DISTRIBUTION OF SOFTWARE WITHOUT MODIFICATION
|
||||||
|
|
||||||
|
The Licensee is authorized to distribute true copies of the Software in
|
||||||
|
Source Code or Object Code form, provided that said distribution
|
||||||
|
complies with all the provisions of the Agreement and is accompanied by:
|
||||||
|
|
||||||
|
1. a copy of the Agreement,
|
||||||
|
|
||||||
|
2. a notice relating to the limitation of both the Licensor's warranty
|
||||||
|
and liability as set forth in Articles 8 and 9,
|
||||||
|
|
||||||
|
and that, in the event that only the Object Code of the Software is
|
||||||
|
redistributed, the Licensee allows effective access to the full Source
|
||||||
|
Code of the Software for a period of at least three years from the
|
||||||
|
distribution of the Software, it being understood that the additional
|
||||||
|
acquisition cost of the Source Code shall not exceed the cost of the
|
||||||
|
data transfer.
|
||||||
|
|
||||||
|
|
||||||
|
5.3.2 DISTRIBUTION OF MODIFIED SOFTWARE
|
||||||
|
|
||||||
|
When the Licensee makes a Contribution to the Software, the terms and
|
||||||
|
conditions for the distribution of the resulting Modified Software
|
||||||
|
become subject to all the provisions of this Agreement.
|
||||||
|
|
||||||
|
The Licensee is authorized to distribute the Modified Software, in
|
||||||
|
source code or object code form, provided that said distribution
|
||||||
|
complies with all the provisions of the Agreement and is accompanied by:
|
||||||
|
|
||||||
|
1. a copy of the Agreement,
|
||||||
|
|
||||||
|
2. a notice relating to the limitation of both the Licensor's warranty
|
||||||
|
and liability as set forth in Articles 8 and 9,
|
||||||
|
|
||||||
|
and, in the event that only the object code of the Modified Software is
|
||||||
|
redistributed,
|
||||||
|
|
||||||
|
3. a note stating the conditions of effective access to the full source
|
||||||
|
code of the Modified Software for a period of at least three years
|
||||||
|
from the distribution of the Modified Software, it being understood
|
||||||
|
that the additional acquisition cost of the source code shall not
|
||||||
|
exceed the cost of the data transfer.
|
||||||
|
|
||||||
|
|
||||||
|
5.3.3 DISTRIBUTION OF EXTERNAL MODULES
|
||||||
|
|
||||||
|
When the Licensee has developed an External Module, the terms and
|
||||||
|
conditions of this Agreement do not apply to said External Module, that
|
||||||
|
may be distributed under a separate license agreement.
|
||||||
|
|
||||||
|
|
||||||
|
5.3.4 COMPATIBILITY WITH OTHER LICENSES
|
||||||
|
|
||||||
|
The Licensee can include a code that is subject to the provisions of one
|
||||||
|
of the versions of the GNU GPL, GNU Affero GPL and/or EUPL in the
|
||||||
|
Modified or unmodified Software, and distribute that entire code under
|
||||||
|
the terms of the same version of the GNU GPL, GNU Affero GPL and/or EUPL.
|
||||||
|
|
||||||
|
The Licensee can include the Modified or unmodified Software in a code
|
||||||
|
that is subject to the provisions of one of the versions of the GNU GPL,
|
||||||
|
GNU Affero GPL and/or EUPL and distribute that entire code under the
|
||||||
|
terms of the same version of the GNU GPL, GNU Affero GPL and/or EUPL.
|
||||||
|
|
||||||
|
|
||||||
|
Article 6 - INTELLECTUAL PROPERTY
|
||||||
|
|
||||||
|
|
||||||
|
6.1 OVER THE INITIAL SOFTWARE
|
||||||
|
|
||||||
|
The Holder owns the economic rights over the Initial Software. Any or
|
||||||
|
all use of the Initial Software is subject to compliance with the terms
|
||||||
|
and conditions under which the Holder has elected to distribute its work
|
||||||
|
and no one shall be entitled to modify the terms and conditions for the
|
||||||
|
distribution of said Initial Software.
|
||||||
|
|
||||||
|
The Holder undertakes that the Initial Software will remain ruled at
|
||||||
|
least by this Agreement, for the duration set forth in Article 4.2 <#term>.
|
||||||
|
|
||||||
|
|
||||||
|
6.2 OVER THE CONTRIBUTIONS
|
||||||
|
|
||||||
|
The Licensee who develops a Contribution is the owner of the
|
||||||
|
intellectual property rights over this Contribution as defined by
|
||||||
|
applicable law.
|
||||||
|
|
||||||
|
|
||||||
|
6.3 OVER THE EXTERNAL MODULES
|
||||||
|
|
||||||
|
The Licensee who develops an External Module is the owner of the
|
||||||
|
intellectual property rights over this External Module as defined by
|
||||||
|
applicable law and is free to choose the type of agreement that shall
|
||||||
|
govern its distribution.
|
||||||
|
|
||||||
|
|
||||||
|
6.4 JOINT PROVISIONS
|
||||||
|
|
||||||
|
The Licensee expressly undertakes:
|
||||||
|
|
||||||
|
1. not to remove, or modify, in any manner, the intellectual property
|
||||||
|
notices attached to the Software;
|
||||||
|
|
||||||
|
2. to reproduce said notices, in an identical manner, in the copies of
|
||||||
|
the Software modified or not.
|
||||||
|
|
||||||
|
The Licensee undertakes not to directly or indirectly infringe the
|
||||||
|
intellectual property rights on the Software of the Holder and/or
|
||||||
|
Contributors, and to take, where applicable, vis-à-vis its staff, any
|
||||||
|
and all measures required to ensure respect of said intellectual
|
||||||
|
property rights of the Holder and/or Contributors.
|
||||||
|
|
||||||
|
|
||||||
|
Article 7 - RELATED SERVICES
|
||||||
|
|
||||||
|
7.1 Under no circumstances shall the Agreement oblige the Licensor to
|
||||||
|
provide technical assistance or maintenance services for the Software.
|
||||||
|
|
||||||
|
However, the Licensor is entitled to offer this type of services. The
|
||||||
|
terms and conditions of such technical assistance, and/or such
|
||||||
|
maintenance, shall be set forth in a separate instrument. Only the
|
||||||
|
Licensor offering said maintenance and/or technical assistance services
|
||||||
|
shall incur liability therefor.
|
||||||
|
|
||||||
|
7.2 Similarly, any Licensor is entitled to offer to its licensees, under
|
||||||
|
its sole responsibility, a warranty, that shall only be binding upon
|
||||||
|
itself, for the redistribution of the Software and/or the Modified
|
||||||
|
Software, under terms and conditions that it is free to decide. Said
|
||||||
|
warranty, and the financial terms and conditions of its application,
|
||||||
|
shall be subject of a separate instrument executed between the Licensor
|
||||||
|
and the Licensee.
|
||||||
|
|
||||||
|
|
||||||
|
Article 8 - LIABILITY
|
||||||
|
|
||||||
|
8.1 Subject to the provisions of Article 8.2, the Licensee shall be
|
||||||
|
entitled to claim compensation for any direct loss it may have suffered
|
||||||
|
from the Software as a result of a fault on the part of the relevant
|
||||||
|
Licensor, subject to providing evidence thereof.
|
||||||
|
|
||||||
|
8.2 The Licensor's liability is limited to the commitments made under
|
||||||
|
this Agreement and shall not be incurred as a result of in particular:
|
||||||
|
(i) loss due the Licensee's total or partial failure to fulfill its
|
||||||
|
obligations, (ii) direct or consequential loss that is suffered by the
|
||||||
|
Licensee due to the use or performance of the Software, and (iii) more
|
||||||
|
generally, any consequential loss. In particular the Parties expressly
|
||||||
|
agree that any or all pecuniary or business loss (i.e. loss of data,
|
||||||
|
loss of profits, operating loss, loss of customers or orders,
|
||||||
|
opportunity cost, any disturbance to business activities) or any or all
|
||||||
|
legal proceedings instituted against the Licensee by a third party,
|
||||||
|
shall constitute consequential loss and shall not provide entitlement to
|
||||||
|
any or all compensation from the Licensor.
|
||||||
|
|
||||||
|
|
||||||
|
Article 9 - WARRANTY
|
||||||
|
|
||||||
|
9.1 The Licensee acknowledges that the scientific and technical
|
||||||
|
state-of-the-art when the Software was distributed did not enable all
|
||||||
|
possible uses to be tested and verified, nor for the presence of
|
||||||
|
possible defects to be detected. In this respect, the Licensee's
|
||||||
|
attention has been drawn to the risks associated with loading, using,
|
||||||
|
modifying and/or developing and reproducing the Software which are
|
||||||
|
reserved for experienced users.
|
||||||
|
|
||||||
|
The Licensee shall be responsible for verifying, by any or all means,
|
||||||
|
the suitability of the product for its requirements, its good working
|
||||||
|
order, and for ensuring that it shall not cause damage to either persons
|
||||||
|
or properties.
|
||||||
|
|
||||||
|
9.2 The Licensor hereby represents, in good faith, that it is entitled
|
||||||
|
to grant all the rights over the Software (including in particular the
|
||||||
|
rights set forth in Article 5 <#scope>).
|
||||||
|
|
||||||
|
9.3 The Licensee acknowledges that the Software is supplied "as is" by
|
||||||
|
the Licensor without any other express or tacit warranty, other than
|
||||||
|
that provided for in Article 9.2 <#good-faith> and, in particular,
|
||||||
|
without any warranty as to its commercial value, its secured, safe,
|
||||||
|
innovative or relevant nature.
|
||||||
|
|
||||||
|
Specifically, the Licensor does not warrant that the Software is free
|
||||||
|
from any error, that it will operate without interruption, that it will
|
||||||
|
be compatible with the Licensee's own equipment and software
|
||||||
|
configuration, nor that it will meet the Licensee's requirements.
|
||||||
|
|
||||||
|
9.4 The Licensor does not either expressly or tacitly warrant that the
|
||||||
|
Software does not infringe any third party intellectual property right
|
||||||
|
relating to a patent, software or any other property right. Therefore,
|
||||||
|
the Licensor disclaims any and all liability towards the Licensee
|
||||||
|
arising out of any or all proceedings for infringement that may be
|
||||||
|
instituted in respect of the use, modification and redistribution of the
|
||||||
|
Software. Nevertheless, should such proceedings be instituted against
|
||||||
|
the Licensee, the Licensor shall provide it with technical and legal
|
||||||
|
expertise for its defense. Such technical and legal expertise shall be
|
||||||
|
decided on a case-by-case basis between the relevant Licensor and the
|
||||||
|
Licensee pursuant to a memorandum of understanding. The Licensor
|
||||||
|
disclaims any and all liability as regards the Licensee's use of the
|
||||||
|
name of the Software. No warranty is given as regards the existence of
|
||||||
|
prior rights over the name of the Software or as regards the existence
|
||||||
|
of a trademark.
|
||||||
|
|
||||||
|
|
||||||
|
Article 10 - TERMINATION
|
||||||
|
|
||||||
|
10.1 In the event of a breach by the Licensee of its obligations
|
||||||
|
hereunder, the Licensor may automatically terminate this Agreement
|
||||||
|
thirty (30) days after notice has been sent to the Licensee and has
|
||||||
|
remained ineffective.
|
||||||
|
|
||||||
|
10.2 A Licensee whose Agreement is terminated shall no longer be
|
||||||
|
authorized to use, modify or distribute the Software. However, any
|
||||||
|
licenses that it may have granted prior to termination of the Agreement
|
||||||
|
shall remain valid subject to their having been granted in compliance
|
||||||
|
with the terms and conditions hereof.
|
||||||
|
|
||||||
|
|
||||||
|
Article 11 - MISCELLANEOUS
|
||||||
|
|
||||||
|
|
||||||
|
11.1 EXCUSABLE EVENTS
|
||||||
|
|
||||||
|
Neither Party shall be liable for any or all delay, or failure to
|
||||||
|
perform the Agreement, that may be attributable to an event of force
|
||||||
|
majeure, an act of God or an outside cause, such as defective
|
||||||
|
functioning or interruptions of the electricity or telecommunications
|
||||||
|
networks, network paralysis following a virus attack, intervention by
|
||||||
|
government authorities, natural disasters, water damage, earthquakes,
|
||||||
|
fire, explosions, strikes and labor unrest, war, etc.
|
||||||
|
|
||||||
|
11.2 Any failure by either Party, on one or more occasions, to invoke
|
||||||
|
one or more of the provisions hereof, shall under no circumstances be
|
||||||
|
interpreted as being a waiver by the interested Party of its right to
|
||||||
|
invoke said provision(s) subsequently.
|
||||||
|
|
||||||
|
11.3 The Agreement cancels and replaces any or all previous agreements,
|
||||||
|
whether written or oral, between the Parties and having the same
|
||||||
|
purpose, and constitutes the entirety of the agreement between said
|
||||||
|
Parties concerning said purpose. No supplement or modification to the
|
||||||
|
terms and conditions hereof shall be effective as between the Parties
|
||||||
|
unless it is made in writing and signed by their duly authorized
|
||||||
|
representatives.
|
||||||
|
|
||||||
|
11.4 In the event that one or more of the provisions hereof were to
|
||||||
|
conflict with a current or future applicable act or legislative text,
|
||||||
|
said act or legislative text shall prevail, and the Parties shall make
|
||||||
|
the necessary amendments so as to comply with said act or legislative
|
||||||
|
text. All other provisions shall remain effective. Similarly, invalidity
|
||||||
|
of a provision of the Agreement, for any reason whatsoever, shall not
|
||||||
|
cause the Agreement as a whole to be invalid.
|
||||||
|
|
||||||
|
|
||||||
|
11.5 LANGUAGE
|
||||||
|
|
||||||
|
The Agreement is drafted in both French and English and both versions
|
||||||
|
are deemed authentic.
|
||||||
|
|
||||||
|
|
||||||
|
Article 12 - NEW VERSIONS OF THE AGREEMENT
|
||||||
|
|
||||||
|
12.1 Any person is authorized to duplicate and distribute copies of this
|
||||||
|
Agreement.
|
||||||
|
|
||||||
|
12.2 So as to ensure coherence, the wording of this Agreement is
|
||||||
|
protected and may only be modified by the authors of the License, who
|
||||||
|
reserve the right to periodically publish updates or new versions of the
|
||||||
|
Agreement, each with a separate number. These subsequent versions may
|
||||||
|
address new issues encountered by Free Software.
|
||||||
|
|
||||||
|
12.3 Any Software distributed under a given version of the Agreement may
|
||||||
|
only be subsequently distributed under the same version of the Agreement
|
||||||
|
or a subsequent version, subject to the provisions of Article 5.3.4
|
||||||
|
<#compatibility>.
|
||||||
|
|
||||||
|
|
||||||
|
Article 13 - GOVERNING LAW AND JURISDICTION
|
||||||
|
|
||||||
|
13.1 The Agreement is governed by French law. The Parties agree to
|
||||||
|
endeavor to seek an amicable solution to any disagreements or disputes
|
||||||
|
that may arise during the performance of the Agreement.
|
||||||
|
|
||||||
|
13.2 Failing an amicable solution within two (2) months as from their
|
||||||
|
occurrence, and unless emergency proceedings are necessary, the
|
||||||
|
disagreements or disputes shall be referred to the Paris Courts having
|
||||||
|
jurisdiction, by the more diligent Party.
|
||||||
@@ -1,3 +1,11 @@
|
|||||||
|
## Version 1.2.6
|
||||||
|
|
||||||
|
* in script command failure report improved
|
||||||
|
|
||||||
|
### Bug fixes
|
||||||
|
|
||||||
|
* command line reading now succeed to parse last argument if it is a string
|
||||||
|
|
||||||
## Version 1.1.0
|
## Version 1.1.0
|
||||||
|
|
||||||
* Parsing quoted string as one argument
|
* Parsing quoted string as one argument
|
||||||
|
|||||||
172
gclc/pom.xml
172
gclc/pom.xml
@@ -1,88 +1,84 @@
|
|||||||
|
|
||||||
<!-- Copyright Bigeon Emmanuel (2014) -->
|
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
|
||||||
<!-- -->
|
<modelVersion>4.0.0</modelVersion>
|
||||||
<!-- emmanuel@bigeon.fr -->
|
<parent>
|
||||||
<!-- -->
|
<groupId>net.bigeon.config</groupId>
|
||||||
<!-- This software is a computer program whose purpose is to -->
|
<artifactId>ebigeon-config</artifactId>
|
||||||
<!-- provide a generic framework for console applications. -->
|
<version>1.8.21</version>
|
||||||
<!-- -->
|
</parent>
|
||||||
<!-- This software is governed by the CeCILL license under French law and -->
|
<groupId>net.bigeon</groupId>
|
||||||
<!-- abiding by the rules of distribution of free software. You can use, -->
|
<artifactId>gclc</artifactId>
|
||||||
<!-- modify and/or redistribute the software under the terms of the CeCILL -->
|
<version>2.0.12-SNAPSHOT</version>
|
||||||
<!-- license as circulated by CEA, CNRS and INRIA at the following URL -->
|
<packaging>jar</packaging>
|
||||||
<!-- "http://www.cecill.info". -->
|
<name>Generic Command Ligne console</name>
|
||||||
<!-- -->
|
<description>A generic framework for console applications, with customized command input and output streams.</description>
|
||||||
<!-- As a counterpart to the access to the source code and rights to copy, -->
|
<url>https://bigeon.net/projects/gclc.html</url>
|
||||||
<!-- modify and redistribute granted by the license, users are provided only -->
|
<inceptionYear>2014</inceptionYear>
|
||||||
<!-- with a limited warranty and the software's author, the holder of the -->
|
<organization>
|
||||||
<!-- economic rights, and the successive licensors have only limited -->
|
<name>Bigeon</name>
|
||||||
<!-- liability. -->
|
<url>https://bigeon.net/</url>
|
||||||
<!-- -->
|
</organization>
|
||||||
<!-- In this respect, the user's attention is drawn to the risks associated -->
|
<licenses>
|
||||||
<!-- with loading, using, modifying and/or developing or reproducing the -->
|
<license>
|
||||||
<!-- software by the user in light of its specific status of free software, -->
|
<distribution>manual</distribution>
|
||||||
<!-- that may mean that it is complicated to manipulate, and that also -->
|
<name>CeCILL 2.1</name>
|
||||||
<!-- therefore means that it is reserved for developers and experienced -->
|
<url>https://cecill.info/licences/Licence_CeCILL_V2.1-en.html</url>
|
||||||
<!-- professionals having in-depth computer knowledge. Users are therefore -->
|
</license>
|
||||||
<!-- encouraged to load and test the software's suitability as regards their -->
|
</licenses>
|
||||||
<!-- requirements in conditions enabling the security of their systems and/or -->
|
<developers>
|
||||||
<!-- data to be ensured and, more generally, to use and operate it in the -->
|
<developer>
|
||||||
<!-- same conditions as regards security. -->
|
<email>emmanuel@bigeon.fr</email>
|
||||||
<!-- -->
|
<name>Emmanuel Bigeon</name>
|
||||||
<!-- The fact that you are presently reading this means that you have had -->
|
<url>bigeon.net</url>
|
||||||
<!-- knowledge of the CeCILL license and that you accept its terms. -->
|
<roles>
|
||||||
|
<role>PM</role>
|
||||||
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
|
</roles>
|
||||||
<modelVersion>4.0.0</modelVersion>
|
</developer>
|
||||||
<artifactId>gclc</artifactId>
|
</developers>
|
||||||
<version>1.2.4</version>
|
<scm>
|
||||||
<packaging>jar</packaging>
|
<developerConnection>scm:git:gogs@git.code.bigeon.net:emmanuel/gclc.git</developerConnection>
|
||||||
<url>http://www.bigeon.fr/emmanuel</url>
|
<tag>HEAD</tag>
|
||||||
<properties>
|
</scm>
|
||||||
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
|
<properties>
|
||||||
<project.scm.id>git.bigeon.net</project.scm.id>
|
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
|
||||||
</properties>
|
<project.scm.id>git.code.bigeon.net</project.scm.id>
|
||||||
<dependencies>
|
<copyright.email>emmanuel@bigeon.fr</copyright.email>
|
||||||
<dependency>
|
<license.licenseName>cecill_2.1</license.licenseName>
|
||||||
<groupId>junit</groupId>
|
</properties>
|
||||||
<artifactId>junit</artifactId>
|
<dependencies>
|
||||||
<version>4.11</version>
|
<dependency>
|
||||||
<scope>test</scope>
|
<groupId>net.bigeon.test</groupId>
|
||||||
</dependency>
|
<artifactId>junitmt</artifactId>
|
||||||
</dependencies>
|
<version>1.0.0</version>
|
||||||
<parent>
|
<scope>test</scope>
|
||||||
<groupId>fr.bigeon</groupId>
|
</dependency>
|
||||||
<artifactId>ebigeon-config</artifactId>
|
</dependencies>
|
||||||
<version>1.7.0</version>
|
<build>
|
||||||
</parent>
|
<plugins>
|
||||||
<build>
|
<plugin>
|
||||||
<plugins>
|
<groupId>org.codehaus.mojo</groupId>
|
||||||
<plugin>
|
<artifactId>license-maven-plugin</artifactId>
|
||||||
<groupId>com.mycila</groupId>
|
<configuration>
|
||||||
<artifactId>license-maven-plugin</artifactId>
|
<extraExtensions>
|
||||||
<configuration>
|
<gclc>properties</gclc>
|
||||||
<header>fr/bigeon/gclc/licensing/cecill/CeCILL-header.txt</header>
|
<txt>properties</txt>
|
||||||
<properties>
|
</extraExtensions>
|
||||||
<owner>Bigeon Emmanuel</owner>
|
</configuration>
|
||||||
<email>emmanuel@bigeon.fr</email>
|
</plugin>
|
||||||
</properties>
|
</plugins>
|
||||||
</configuration>
|
</build>
|
||||||
<executions>
|
<reporting>
|
||||||
<execution>
|
<plugins>
|
||||||
<goals>
|
<plugin>
|
||||||
<goal>check</goal>
|
<groupId>com.github.sevntu-checkstyle</groupId>
|
||||||
</goals>
|
<artifactId>dsm-maven-plugin</artifactId>
|
||||||
</execution>
|
<version>2.2.0</version>
|
||||||
</executions>
|
</plugin>
|
||||||
</plugin>
|
<plugin>
|
||||||
</plugins>
|
<groupId>org.codehaus.mojo</groupId>
|
||||||
</build>
|
<artifactId>jdepend-maven-plugin</artifactId>
|
||||||
<inceptionYear>2014</inceptionYear>
|
<version>2.0</version>
|
||||||
<name>Generic Command Ligne console</name>
|
</plugin>
|
||||||
<description>provide a generic framework for console applications</description>
|
</plugins>
|
||||||
<scm>
|
</reporting>
|
||||||
|
</project>
|
||||||
<developerConnection>scm:git:gogs@git.code.bigeon.net:emmanuel/gclc.git</developerConnection>
|
|
||||||
<tag>gclc-1.2.4</tag>
|
|
||||||
</scm>
|
|
||||||
</project>
|
|
||||||
|
|||||||
@@ -1,267 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright Bigeon Emmanuel (2014)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* provide a generic framework for console applications.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
/** gclc:fr.bigeon.gclc.ConsoleApplication.java
|
|
||||||
* Created on: Sep 6, 2014 */
|
|
||||||
package fr.bigeon.gclc;
|
|
||||||
|
|
||||||
import java.io.IOException;
|
|
||||||
import java.util.ArrayList;
|
|
||||||
import java.util.Arrays;
|
|
||||||
import java.util.List;
|
|
||||||
import java.util.logging.Level;
|
|
||||||
import java.util.logging.Logger;
|
|
||||||
|
|
||||||
import fr.bigeon.gclc.command.ExitCommand;
|
|
||||||
import fr.bigeon.gclc.command.HelpExecutor;
|
|
||||||
import fr.bigeon.gclc.command.ICommand;
|
|
||||||
import fr.bigeon.gclc.command.ICommandProvider;
|
|
||||||
import fr.bigeon.gclc.command.SubedCommand;
|
|
||||||
import fr.bigeon.gclc.exception.CommandParsingException;
|
|
||||||
import fr.bigeon.gclc.exception.CommandRunException;
|
|
||||||
import fr.bigeon.gclc.exception.CommandRunExceptionType;
|
|
||||||
import fr.bigeon.gclc.exception.InvalidCommandName;
|
|
||||||
import fr.bigeon.gclc.i18n.Messages;
|
|
||||||
import fr.bigeon.gclc.manager.ConsoleManager;
|
|
||||||
import fr.bigeon.gclc.manager.SystemConsoleManager;
|
|
||||||
|
|
||||||
/** <p>
|
|
||||||
* A {@link ConsoleApplication} is an application that require the user to input
|
|
||||||
* commands.
|
|
||||||
* <p>
|
|
||||||
* A typical use case is the following:
|
|
||||||
*
|
|
||||||
* <pre>
|
|
||||||
* {@link ConsoleApplication} app = new {@link ConsoleApplication#ConsoleApplication(String, String, String) ConsoleApplication("exit", "welcome", "see you latter")};
|
|
||||||
* app.{@link ConsoleApplication#add(ICommand) add}("my_command", new {@link ICommand MyCommand()});
|
|
||||||
* app.{@link ConsoleApplication#start start}();
|
|
||||||
* </pre>
|
|
||||||
* <p>
|
|
||||||
* That will launch in the console application that will display "welcome",
|
|
||||||
* return a line and prompt the user for the command until he inputs the
|
|
||||||
* <code>exit</code> command. Then it will print "see you latter" and exit the
|
|
||||||
* start method.
|
|
||||||
*
|
|
||||||
* @author Emmanuel BIGEON */
|
|
||||||
public class ConsoleApplication implements ICommandProvider {
|
|
||||||
|
|
||||||
/** The class logger */
|
|
||||||
private static final Logger LOGGER = Logger
|
|
||||||
.getLogger(ConsoleApplication.class.getName());
|
|
||||||
/** The welcome message */
|
|
||||||
private final String header;
|
|
||||||
/** The good bye message */
|
|
||||||
private final String footer;
|
|
||||||
/** The console manager */
|
|
||||||
protected final ConsoleManager manager;
|
|
||||||
/** The container of commands */
|
|
||||||
private final SubedCommand root;
|
|
||||||
/** The state of this application */
|
|
||||||
private boolean running;
|
|
||||||
/** The listeners */
|
|
||||||
private final List<CommandRequestListener> listeners = new ArrayList<>();
|
|
||||||
|
|
||||||
/** @param manager the manager
|
|
||||||
* @param welcome the welcoming message
|
|
||||||
* @param goodbye the goodbye message */
|
|
||||||
public ConsoleApplication(ConsoleManager manager, String welcome,
|
|
||||||
String goodbye) {
|
|
||||||
this.header = welcome;
|
|
||||||
this.footer = goodbye;
|
|
||||||
this.manager = manager;
|
|
||||||
root = new SubedCommand(new String());
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param manager the manager
|
|
||||||
* @param exit the keyword for the exit command of this application
|
|
||||||
* @param welcome the header message to display on launch of this
|
|
||||||
* application
|
|
||||||
* @param goodbye the message to display on exit
|
|
||||||
* @throws InvalidCommandName if the exit command name is invalid
|
|
||||||
* @deprecated since 1.2.0, use the {@link #add(ICommand)} method to add the
|
|
||||||
* exit command */
|
|
||||||
@Deprecated
|
|
||||||
public ConsoleApplication(ConsoleManager manager, String exit,
|
|
||||||
String welcome, String goodbye) throws InvalidCommandName {
|
|
||||||
this(manager, welcome, goodbye);
|
|
||||||
root.add(new ExitCommand(exit, this));
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param exit the keyword for the exit command of this application
|
|
||||||
* @param welcome the header message to display on launch of this
|
|
||||||
* application
|
|
||||||
* @param goodbye the message to display on exit
|
|
||||||
* @throws InvalidCommandName if the exit command name is invalid
|
|
||||||
* @deprecated since 1.2.0, use the {@link #add(ICommand)} method to add the
|
|
||||||
* command and create this console using the
|
|
||||||
* {@link #ConsoleApplication(ConsoleManager, String, String)}
|
|
||||||
* method with a {@link SystemConsoleManager} as argument */
|
|
||||||
@Deprecated
|
|
||||||
public ConsoleApplication(String exit, String welcome,
|
|
||||||
String goodbye) throws InvalidCommandName {
|
|
||||||
this(new SystemConsoleManager(), welcome, goodbye);
|
|
||||||
root.add(new ExitCommand(exit, this));
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public final boolean add(ICommand cmd) throws InvalidCommandName {
|
|
||||||
return root.add(cmd);
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Adds help command on the given key
|
|
||||||
*
|
|
||||||
* @param cmd the handle for help
|
|
||||||
* @return if the help command was added
|
|
||||||
* @throws InvalidCommandName if the help command was not valid
|
|
||||||
* @deprecated since 1.2.0 use the {@link #add(ICommand)} with a
|
|
||||||
* {@link HelpExecutor} instead */
|
|
||||||
@Deprecated
|
|
||||||
public final boolean addHelpCommand(String cmd) throws InvalidCommandName {
|
|
||||||
return root.add(new HelpExecutor(cmd, manager, root));
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Add a command request listener.
|
|
||||||
* <p>
|
|
||||||
* A listener can listen several times to the same application.
|
|
||||||
*
|
|
||||||
* @param listener the listener to add. */
|
|
||||||
public final void addListener(CommandRequestListener listener) {
|
|
||||||
listeners.add(listener);
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see
|
|
||||||
* fr.bigeon.gclc.command.ICommandProvider#executeSub(java.lang.String,
|
|
||||||
* java.lang.String[]) */
|
|
||||||
@Override
|
|
||||||
public final void executeSub(String command,
|
|
||||||
String... args) throws CommandRunException {
|
|
||||||
root.executeSub(command, args);
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Exit this running application before next command prompt */
|
|
||||||
public final void exit() {
|
|
||||||
LOGGER.fine("Request exiting application..."); //$NON-NLS-1$
|
|
||||||
running = false;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.command.ICommandProvider#get(java.lang.String) */
|
|
||||||
@Override
|
|
||||||
public final ICommand get(String command) {
|
|
||||||
return root.get(command);
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @return the manager */
|
|
||||||
public final ConsoleManager getManager() {
|
|
||||||
return manager;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param cmd the command to interpret
|
|
||||||
* @throws IOException if the manager was closed */
|
|
||||||
public final void interpretCommand(String cmd) throws IOException {
|
|
||||||
List<String> args;
|
|
||||||
try {
|
|
||||||
args = GCLCConstants.splitCommand(cmd);
|
|
||||||
} catch (CommandParsingException e1) {
|
|
||||||
manager.println("Command line cannot be parsed"); //$NON-NLS-1$
|
|
||||||
LOGGER.log(Level.INFO, "Invalid user command " + cmd, e1); //$NON-NLS-1$
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
if (!args.isEmpty()) {
|
|
||||||
try {
|
|
||||||
executeSub(args.get(0), Arrays.copyOfRange(
|
|
||||||
args.toArray(new String[0]), 1, args.size()));
|
|
||||||
} catch (final CommandRunException e) {
|
|
||||||
LOGGER.log(Level.WARNING, "Command failed: " + cmd, e); //$NON-NLS-1$
|
|
||||||
manager.println(Messages
|
|
||||||
.getString("ConsoleApplication.cmd.failed", cmd)); //$NON-NLS-1$
|
|
||||||
manager.println(e.getLocalizedMessage());
|
|
||||||
if (e.getType() == CommandRunExceptionType.USAGE) {
|
|
||||||
e.getSource().help(getManager());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param listener the listener to remove (once) */
|
|
||||||
public final void removeListener(CommandRequestListener listener) {
|
|
||||||
for (int i = 0; i < listeners.size(); i++) {
|
|
||||||
if (listeners.get(i) == listener) {
|
|
||||||
listeners.remove(i);
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Launches the prompting application */
|
|
||||||
public final void start() {
|
|
||||||
try {
|
|
||||||
running = true;
|
|
||||||
if (header != null) {
|
|
||||||
manager.println(header);
|
|
||||||
}
|
|
||||||
do {
|
|
||||||
final String cmd = manager.prompt();
|
|
||||||
if (cmd == null || cmd.isEmpty()) {
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
for (final CommandRequestListener listener : listeners) {
|
|
||||||
listener.commandRequest(cmd);
|
|
||||||
}
|
|
||||||
interpretCommand(cmd);
|
|
||||||
} while (running);
|
|
||||||
if (footer != null) {
|
|
||||||
manager.println(footer);
|
|
||||||
}
|
|
||||||
LOGGER.fine("Exiting application."); //$NON-NLS-1$
|
|
||||||
} catch (IOException e) {
|
|
||||||
// The manager was closed
|
|
||||||
running = false;
|
|
||||||
LOGGER.log(Level.WARNING,
|
|
||||||
"The console manager was closed. Closing the application as no one can reach it.", //$NON-NLS-1$
|
|
||||||
e);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @return if the application is running */
|
|
||||||
public boolean isRunning() {
|
|
||||||
return running;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @return the root */
|
|
||||||
public SubedCommand getRoot() {
|
|
||||||
return root;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,175 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright Bigeon Emmanuel (2014)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* provide a generic framework for console applications.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
/**
|
|
||||||
* gclc:fr.bigeon.gclc.command.CommandParameters.java
|
|
||||||
* Created on: Dec 24, 2014
|
|
||||||
*/
|
|
||||||
package fr.bigeon.gclc.command;
|
|
||||||
|
|
||||||
import java.util.ArrayList;
|
|
||||||
import java.util.Collections;
|
|
||||||
import java.util.HashMap;
|
|
||||||
import java.util.List;
|
|
||||||
import java.util.Map;
|
|
||||||
import java.util.Set;
|
|
||||||
|
|
||||||
/** <p>
|
|
||||||
* An object representing a collection of parameters. It is used for defaulting
|
|
||||||
* values.
|
|
||||||
*
|
|
||||||
* @author Emmanuel BIGEON */
|
|
||||||
public class CommandParameters {
|
|
||||||
/**
|
|
||||||
*
|
|
||||||
*/
|
|
||||||
private static final int STRINGARG_NUMBER_OF_ELEMENTS = 2;
|
|
||||||
/** Boolean arguments */
|
|
||||||
private final Map<String, Boolean> boolArgs = new HashMap<>();
|
|
||||||
/** String arguments */
|
|
||||||
private final Map<String, String> stringArgs = new HashMap<>();
|
|
||||||
/** Arguments restriction on the named ones */
|
|
||||||
private final boolean strict;
|
|
||||||
/** additional (unnamed) parameters */
|
|
||||||
private final List<String> additional = new ArrayList<>();
|
|
||||||
|
|
||||||
/** @param bools the boolean parameters
|
|
||||||
* @param strings the string parameters
|
|
||||||
* @param strict if the argument are restricted to the declared ones */
|
|
||||||
@SuppressWarnings("boxing")
|
|
||||||
public CommandParameters(Set<String> bools, Set<String> strings,
|
|
||||||
boolean strict) {
|
|
||||||
for (final String string : bools) {
|
|
||||||
boolArgs.put(string, false);
|
|
||||||
}
|
|
||||||
for (final String string : strings) {
|
|
||||||
stringArgs.put(string, null);
|
|
||||||
}
|
|
||||||
this.strict = strict;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param key the key
|
|
||||||
* @return the associated value, null if it was not specified */
|
|
||||||
public String get(String key) {
|
|
||||||
return stringArgs.get(key);
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @return additional non parsed parameters */
|
|
||||||
public List<String> getAdditionals() {
|
|
||||||
return Collections.unmodifiableList(additional);
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param key the key
|
|
||||||
* @return if the key was specified */
|
|
||||||
@SuppressWarnings("boxing")
|
|
||||||
public boolean getBool(String key) {
|
|
||||||
return boolArgs.get(key);
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param args the arguments to parse
|
|
||||||
* @return if the arguments were parsed */
|
|
||||||
public boolean parseArgs(String... args) {
|
|
||||||
int i = 0;
|
|
||||||
while (i < args.length) {
|
|
||||||
String next = null;
|
|
||||||
if (i < args.length - 1) {
|
|
||||||
next = args[i + 1];
|
|
||||||
}
|
|
||||||
int p = parseArg(args[i], next);
|
|
||||||
if (p == 0) {
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
i += p;
|
|
||||||
}
|
|
||||||
return true;
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Attempt to parse an argument.
|
|
||||||
* <p>
|
|
||||||
* This method return 0 if the parsing was incorrect, or the number of
|
|
||||||
* parsed elements.
|
|
||||||
*
|
|
||||||
* @param arg the argument
|
|
||||||
* @param next the next element
|
|
||||||
* @return the number of element read */
|
|
||||||
private int parseArg(String arg, String next) {
|
|
||||||
if (!arg.startsWith("-")) { //$NON-NLS-1$
|
|
||||||
return 1;
|
|
||||||
}
|
|
||||||
String name = arg.substring(1);
|
|
||||||
if (boolArgs.containsKey(name)) {
|
|
||||||
boolArgs.put(name, Boolean.TRUE);
|
|
||||||
return 1;
|
|
||||||
}
|
|
||||||
if (stringArgs.containsKey(name)) {
|
|
||||||
return parseStringArg(name, next);
|
|
||||||
}
|
|
||||||
if (strict) {
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
additional.add(name);
|
|
||||||
return 1;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Add a string arg value
|
|
||||||
*
|
|
||||||
* @param name the string arg name
|
|
||||||
* @param next the string arg value
|
|
||||||
* @return 2 or 0 if next is invalid */
|
|
||||||
private int parseStringArg(String name, String next) {
|
|
||||||
if (next == null) {
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
stringArgs.put(name, next);
|
|
||||||
return STRINGARG_NUMBER_OF_ELEMENTS;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param string the key
|
|
||||||
* @param value the value */
|
|
||||||
@SuppressWarnings("boxing")
|
|
||||||
public void set(String string, boolean value) {
|
|
||||||
if (boolArgs.containsKey(string)) {
|
|
||||||
boolArgs.put(string, value);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param string the key
|
|
||||||
* @param value the value */
|
|
||||||
public void set(String string, String value) {
|
|
||||||
if (stringArgs.containsKey(string)) {
|
|
||||||
stringArgs.put(string, value);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,100 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright Bigeon Emmanuel (2014)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* provide a generic framework for console applications.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
/** acide:fr.bigeon.acide.CommandProvider.java
|
|
||||||
* Created on: Aug 6, 2014 */
|
|
||||||
package fr.bigeon.gclc.command;
|
|
||||||
|
|
||||||
import java.util.HashSet;
|
|
||||||
import java.util.Set;
|
|
||||||
|
|
||||||
import fr.bigeon.gclc.exception.CommandRunException;
|
|
||||||
import fr.bigeon.gclc.exception.InvalidCommandName;
|
|
||||||
import fr.bigeon.gclc.i18n.Messages;
|
|
||||||
|
|
||||||
/** <p>
|
|
||||||
* A command provider is a map of key word to command to execute
|
|
||||||
*
|
|
||||||
* @author Emmanuel BIGEON */
|
|
||||||
public class CommandProvider implements ICommandProvider {
|
|
||||||
/** The minus character */
|
|
||||||
private static final String MINUS = "-"; //$NON-NLS-1$
|
|
||||||
/** The space character */
|
|
||||||
private static final String SPACE = " "; //$NON-NLS-1$
|
|
||||||
/** The commands map */
|
|
||||||
protected final Set<ICommand> commands;
|
|
||||||
|
|
||||||
/** Create a command provider */
|
|
||||||
public CommandProvider() {
|
|
||||||
super();
|
|
||||||
commands = new HashSet<>();
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.command.ICommandProvider#add(java.lang.String,
|
|
||||||
* fr.bigeon.gclc.command.Command) */
|
|
||||||
@Override
|
|
||||||
public boolean add(ICommand value) throws InvalidCommandName {
|
|
||||||
final String name = value.getCommandName();
|
|
||||||
if (name == null || name.startsWith(MINUS) || name.contains(SPACE)) {
|
|
||||||
throw new InvalidCommandName();
|
|
||||||
}
|
|
||||||
return commands.add(value);
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public void executeSub(String cmd,
|
|
||||||
String... args) throws CommandRunException {
|
|
||||||
for (final ICommand command : commands) {
|
|
||||||
if (command.getCommandName().equals(cmd)) {
|
|
||||||
command.execute(args);
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
throw new CommandRunException(
|
|
||||||
Messages.getString("CommandProvider.unrecognized", cmd), null); //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.command.ICommandProvider#get(java.lang.String) */
|
|
||||||
@Override
|
|
||||||
public ICommand get(String commandName) {
|
|
||||||
for (final ICommand command : commands) {
|
|
||||||
if (command.getCommandName().equals(commandName)) {
|
|
||||||
return command;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,97 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright Bigeon Emmanuel (2014)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* provide a generic framework for console applications.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
/**
|
|
||||||
* gclc:fr.bigeon.gclc.ExitCommand.java
|
|
||||||
* Created on: Jun 8, 2016
|
|
||||||
*/
|
|
||||||
package fr.bigeon.gclc.command;
|
|
||||||
|
|
||||||
import java.io.IOException;
|
|
||||||
|
|
||||||
import fr.bigeon.gclc.ConsoleApplication;
|
|
||||||
import fr.bigeon.gclc.manager.ConsoleManager;
|
|
||||||
import fr.bigeon.gclc.prompt.CLIPrompterMessages;
|
|
||||||
|
|
||||||
/** <p>
|
|
||||||
* A command to exit a {@link ConsoleApplication}.
|
|
||||||
*
|
|
||||||
* @author Emmanuel BIGEON */
|
|
||||||
public class ExitCommand implements ICommand {
|
|
||||||
/** The exit command manual message key */
|
|
||||||
private static final String EXIT_MAN = "exit.man"; //$NON-NLS-1$
|
|
||||||
/** The tip of the exit command */
|
|
||||||
private static final String EXIT = "exit.tip"; //$NON-NLS-1$
|
|
||||||
/** The application that will be exited when this command runs */
|
|
||||||
private final ConsoleApplication app;
|
|
||||||
/** The exit command name */
|
|
||||||
private final String name;
|
|
||||||
|
|
||||||
/** @param name the name of the command
|
|
||||||
* @param app the application to exit */
|
|
||||||
public ExitCommand(String name, ConsoleApplication app) {
|
|
||||||
this.name = name;
|
|
||||||
this.app = app;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** The actions to take before exiting */
|
|
||||||
public void beforeExit() {
|
|
||||||
// Do nothing by default
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public final void execute(String... args) {
|
|
||||||
beforeExit();
|
|
||||||
app.exit();
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.command.ICommand#getCommandName() */
|
|
||||||
@Override
|
|
||||||
public final String getCommandName() {
|
|
||||||
return name;
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public void help(ConsoleManager manager,
|
|
||||||
String... args) throws IOException {
|
|
||||||
manager.println(
|
|
||||||
CLIPrompterMessages.getString(EXIT_MAN, (Object[]) args));
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public String tip() {
|
|
||||||
return CLIPrompterMessages.getString(EXIT);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,106 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright Bigeon Emmanuel (2014)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* provide a generic framework for console applications.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
/**
|
|
||||||
* gclc:fr.bigeon.gclc.command.HelpExecutor.java
|
|
||||||
* Created on: Sep 6, 2014
|
|
||||||
*/
|
|
||||||
package fr.bigeon.gclc.command;
|
|
||||||
|
|
||||||
import java.io.IOException;
|
|
||||||
|
|
||||||
import fr.bigeon.gclc.exception.CommandRunException;
|
|
||||||
import fr.bigeon.gclc.exception.CommandRunExceptionType;
|
|
||||||
import fr.bigeon.gclc.manager.ConsoleManager;
|
|
||||||
import fr.bigeon.gclc.prompt.CLIPrompterMessages;
|
|
||||||
|
|
||||||
/** A command to print help of an other command.
|
|
||||||
* <p>
|
|
||||||
* This command will display the help of an other command
|
|
||||||
*
|
|
||||||
* @author Emmanuel BIGEON */
|
|
||||||
public class HelpExecutor extends Command {
|
|
||||||
|
|
||||||
/** The command to execute the help of */
|
|
||||||
private final ICommand cmd;
|
|
||||||
/** The console manager */
|
|
||||||
private final ConsoleManager consoleManager;
|
|
||||||
|
|
||||||
/** @param cmdName the command name
|
|
||||||
* @param consoleManager the manager for the console
|
|
||||||
* @param cmd the command to execute the help of */
|
|
||||||
public HelpExecutor(String cmdName, ConsoleManager consoleManager,
|
|
||||||
ICommand cmd) {
|
|
||||||
super(cmdName);
|
|
||||||
this.cmd = cmd;
|
|
||||||
if (consoleManager == null) {
|
|
||||||
throw new NullPointerException(
|
|
||||||
"Argument cannot be null: ConsoleManager"); //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
this.consoleManager = consoleManager;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.command.Command#execute(java.lang.String[]) */
|
|
||||||
@Override
|
|
||||||
public void execute(String... args) throws CommandRunException {
|
|
||||||
try {
|
|
||||||
cmd.help(consoleManager, args);
|
|
||||||
} catch (IOException e) {
|
|
||||||
throw new CommandRunException(CommandRunExceptionType.INTERACTION,
|
|
||||||
"Console manager closed", e, this); //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.command.Command#brief() */
|
|
||||||
@Override
|
|
||||||
protected String brief() {
|
|
||||||
return " A command to get help for other commands"; //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.command.Command#usagePattern() */
|
|
||||||
@Override
|
|
||||||
protected String usagePattern() {
|
|
||||||
return getCommandName() + " <otherCommand>"; //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.command.Command#tip() */
|
|
||||||
@Override
|
|
||||||
public String tip() {
|
|
||||||
return CLIPrompterMessages.getString("help.cmd.tip"); //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,83 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright Bigeon Emmanuel (2014)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* provide a generic framework for console applications.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
/**
|
|
||||||
* gclc:fr.bigeon.gclc.command.ICommand.java
|
|
||||||
* Created on: May 31, 2016
|
|
||||||
*/
|
|
||||||
package fr.bigeon.gclc.command;
|
|
||||||
|
|
||||||
import java.io.IOException;
|
|
||||||
|
|
||||||
import fr.bigeon.gclc.exception.CommandRunException;
|
|
||||||
import fr.bigeon.gclc.manager.ConsoleManager;
|
|
||||||
|
|
||||||
/** The contract of commands
|
|
||||||
* <p>
|
|
||||||
* This interface describe the contract of commands
|
|
||||||
*
|
|
||||||
* @author Emmanuel Bigeon */
|
|
||||||
public interface ICommand {
|
|
||||||
|
|
||||||
/** @param args the arguments of the command (some expect an empty array)
|
|
||||||
* @throws CommandRunException if the execution of the command failed for
|
|
||||||
* any reason */
|
|
||||||
void execute(String... args) throws CommandRunException;
|
|
||||||
|
|
||||||
/** @return the command's name */
|
|
||||||
String getCommandName();
|
|
||||||
|
|
||||||
/** This prints the help associated to this command.
|
|
||||||
* <p>
|
|
||||||
* The default behavior is to print:
|
|
||||||
*
|
|
||||||
* <pre>
|
|
||||||
* [Command name]
|
|
||||||
* [brief message]
|
|
||||||
*
|
|
||||||
* Usage:
|
|
||||||
* [Usage pattern]
|
|
||||||
*
|
|
||||||
* [Usage details]
|
|
||||||
* </pre>
|
|
||||||
*
|
|
||||||
* @param manager the manager to print the data
|
|
||||||
* @param args the arguments called with the help
|
|
||||||
* @throws IOException if the manager was closed */
|
|
||||||
void help(ConsoleManager manager, String... args) throws IOException;
|
|
||||||
|
|
||||||
/** @return a tip on the command */
|
|
||||||
String tip();
|
|
||||||
|
|
||||||
}
|
|
||||||
@@ -1,82 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright Bigeon Emmanuel (2014)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* provide a generic framework for console applications.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
/** gclc:fr.bigeon.gclc.command.ICommandProvider.java
|
|
||||||
* Created on: Sep 6, 2014 */
|
|
||||||
package fr.bigeon.gclc.command;
|
|
||||||
|
|
||||||
import fr.bigeon.gclc.exception.CommandRunException;
|
|
||||||
import fr.bigeon.gclc.exception.InvalidCommandName;
|
|
||||||
|
|
||||||
/** <p>
|
|
||||||
* An ICommadProvider is a provider of commands that can register commands under
|
|
||||||
* some keywords.
|
|
||||||
*
|
|
||||||
* @author Emmanuel BIGEON */
|
|
||||||
public interface ICommandProvider {
|
|
||||||
|
|
||||||
/** <p>
|
|
||||||
* Adds a command to this provider, if no command was associated with the
|
|
||||||
* given key
|
|
||||||
*
|
|
||||||
* @param value the command to execute
|
|
||||||
* @return if the command was added
|
|
||||||
* @throws InvalidCommandName if the command name is invalid */
|
|
||||||
public boolean add(ICommand value) throws InvalidCommandName;
|
|
||||||
|
|
||||||
/** <p>
|
|
||||||
* This method executes the command with the given name found. If no command
|
|
||||||
* with this name is found, an error command is usually executed. If there
|
|
||||||
* are several commands with the same name, the behavior is unspecified.
|
|
||||||
* Depending on the implementation, it may run an error command or prompt
|
|
||||||
* the user for a choice.
|
|
||||||
*
|
|
||||||
* @param command the name of the command the user wishes to execute
|
|
||||||
* @param args the arguments for the command
|
|
||||||
* @throws CommandRunException if the command failed to run */
|
|
||||||
public void executeSub(String command,
|
|
||||||
String... args) throws CommandRunException;
|
|
||||||
|
|
||||||
/** <p>
|
|
||||||
* This method provide the command with the given name found. If no command
|
|
||||||
* with this name is found, an error command is usually returned. If there
|
|
||||||
* are several commands with the same name, the behavior is unspecified.
|
|
||||||
* Depending on the implementation, it may return an error command or the
|
|
||||||
* first command with this name found.
|
|
||||||
*
|
|
||||||
* @param command the name of the command the user wishes to execute
|
|
||||||
* @return the command to execute */
|
|
||||||
public ICommand get(String command);
|
|
||||||
|
|
||||||
}
|
|
||||||
@@ -1,163 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright Bigeon Emmanuel (2014)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* provide a generic framework for console applications.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
/**
|
|
||||||
* gclc:fr.bigeon.gclc.command.ParametrizedCommand.java
|
|
||||||
* Created on: Dec 24, 2014
|
|
||||||
*/
|
|
||||||
package fr.bigeon.gclc.command;
|
|
||||||
|
|
||||||
import java.io.IOException;
|
|
||||||
import java.util.ArrayList;
|
|
||||||
import java.util.HashMap;
|
|
||||||
import java.util.List;
|
|
||||||
import java.util.Map;
|
|
||||||
|
|
||||||
import fr.bigeon.gclc.exception.CommandRunException;
|
|
||||||
import fr.bigeon.gclc.exception.CommandRunExceptionType;
|
|
||||||
import fr.bigeon.gclc.manager.ConsoleManager;
|
|
||||||
|
|
||||||
/** <p>
|
|
||||||
* A command relying on the {@link CommandParameters} to store parameters values
|
|
||||||
*
|
|
||||||
* @author Emmanuel BIGEON */
|
|
||||||
public abstract class ParametrizedCommand extends Command {
|
|
||||||
|
|
||||||
/** If the command may use interactive prompting for required parameters
|
|
||||||
* that
|
|
||||||
* were not provided on execution */
|
|
||||||
private boolean interactive = true;
|
|
||||||
/** The manager */
|
|
||||||
protected final ConsoleManager manager;
|
|
||||||
/** The boolean parameters mandatory status */
|
|
||||||
private final Map<String, Boolean> boolParams = new HashMap<>();
|
|
||||||
/** The string parameters mandatory status */
|
|
||||||
private final Map<String, Boolean> stringParams = new HashMap<>();
|
|
||||||
/** The parameters mandatory status */
|
|
||||||
private final Map<String, Boolean> params = new HashMap<>();
|
|
||||||
/** The restriction of provided parameters on execution to declared
|
|
||||||
* paramters
|
|
||||||
* in the status maps. */
|
|
||||||
private final boolean strict;
|
|
||||||
|
|
||||||
/** @param manager the manager
|
|
||||||
* @param name the name */
|
|
||||||
public ParametrizedCommand(ConsoleManager manager, String name) {
|
|
||||||
this(manager, name, true);
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param manager the manager
|
|
||||||
* @param name the name
|
|
||||||
* @param strict if the arguments are restricted to the declared ones */
|
|
||||||
public ParametrizedCommand(ConsoleManager manager, String name,
|
|
||||||
boolean strict) {
|
|
||||||
super(name);
|
|
||||||
this.manager = manager;
|
|
||||||
interactive = manager != null;
|
|
||||||
this.strict = strict;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** <p>
|
|
||||||
* Add a parameter to the defined parameters
|
|
||||||
*
|
|
||||||
* @param param the parameter identification
|
|
||||||
* @param stringOrBool if the parameter is a parameter with an argument
|
|
||||||
* @param needed if the parameter is required */
|
|
||||||
@SuppressWarnings("boxing")
|
|
||||||
protected void addParameter(String param, boolean stringOrBool,
|
|
||||||
boolean needed) {
|
|
||||||
if (params.containsKey(param)) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
params.put(param, needed);
|
|
||||||
if (stringOrBool) {
|
|
||||||
stringParams.put(param, needed);
|
|
||||||
} else {
|
|
||||||
if (needed) {
|
|
||||||
// ERROR the boolean parameters cannot be needed
|
|
||||||
}
|
|
||||||
boolParams.put(param, needed);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param parameters the command parameters */
|
|
||||||
protected abstract void doExecute(CommandParameters parameters);
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.command.Command#execute(java.lang.String[]) */
|
|
||||||
@SuppressWarnings("boxing")
|
|
||||||
@Override
|
|
||||||
public final void execute(String... args) throws CommandRunException {
|
|
||||||
final CommandParameters parameters = new CommandParameters(
|
|
||||||
boolParams.keySet(), stringParams.keySet(), strict);
|
|
||||||
if (!parameters.parseArgs(args)) {
|
|
||||||
// ERROR the parameters could not be correctly parsed
|
|
||||||
throw new CommandRunException(CommandRunExceptionType.USAGE,
|
|
||||||
"Unable to read arguments", this); //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
final List<String> toProvide = new ArrayList<>();
|
|
||||||
for (final String string : params.keySet()) {
|
|
||||||
if (params.get(string) && parameters.get(string) == null) {
|
|
||||||
if (!interactive) {
|
|
||||||
return;
|
|
||||||
}
|
|
||||||
toProvide.add(string);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
// for each needed parameters that is missing, prompt the user.
|
|
||||||
fillParameters(toProvide, parameters);
|
|
||||||
doExecute(parameters);
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param parameters the parameter list to complete
|
|
||||||
* @param toProvide the parameters to ask for
|
|
||||||
* @throws CommandRunException if the manager was closed */
|
|
||||||
private void fillParameters(List<String> toProvide,
|
|
||||||
CommandParameters parameters) throws CommandRunException {
|
|
||||||
for (final String string : toProvide) {
|
|
||||||
String value;
|
|
||||||
try {
|
|
||||||
value = manager.prompt(string);
|
|
||||||
while (value.isEmpty()) {
|
|
||||||
value = manager.prompt(string);
|
|
||||||
}
|
|
||||||
} catch (IOException e) {
|
|
||||||
throw new CommandRunException(
|
|
||||||
CommandRunExceptionType.INTERACTION,
|
|
||||||
"Interactive command but manager closed...", e, this); //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
parameters.set(string, value);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,151 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright Bigeon Emmanuel (2014)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* provide a generic framework for console applications.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
/**
|
|
||||||
* gclc:fr.bigeon.gclc.command.ScriptExecution.java
|
|
||||||
* Created on: Jun 12, 2016
|
|
||||||
*/
|
|
||||||
package fr.bigeon.gclc.command;
|
|
||||||
|
|
||||||
import java.io.BufferedReader;
|
|
||||||
import java.io.File;
|
|
||||||
import java.io.FileReader;
|
|
||||||
import java.io.IOException;
|
|
||||||
import java.text.MessageFormat;
|
|
||||||
import java.util.Arrays;
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
import fr.bigeon.gclc.ConsoleApplication;
|
|
||||||
import fr.bigeon.gclc.GCLCConstants;
|
|
||||||
import fr.bigeon.gclc.exception.CommandParsingException;
|
|
||||||
import fr.bigeon.gclc.exception.CommandRunException;
|
|
||||||
import fr.bigeon.gclc.exception.CommandRunExceptionType;
|
|
||||||
|
|
||||||
/** A command that will laucnh a series of command from a file
|
|
||||||
* <p>
|
|
||||||
* This command will read a file and execute each non empty non commented line
|
|
||||||
* as a command of the application.
|
|
||||||
*
|
|
||||||
* @author Emmanuel Bigeon */
|
|
||||||
public class ScriptExecution extends Command {
|
|
||||||
|
|
||||||
/** The application */
|
|
||||||
private final ConsoleApplication application;
|
|
||||||
/** The commenting prefix */
|
|
||||||
private final String commentPrefix;
|
|
||||||
|
|
||||||
/** @param name the name of the command
|
|
||||||
* @param application the application
|
|
||||||
* @param commentPrefix the comment prefix in the script files */
|
|
||||||
public ScriptExecution(String name, ConsoleApplication application,
|
|
||||||
String commentPrefix) {
|
|
||||||
super(name);
|
|
||||||
this.application = application;
|
|
||||||
this.commentPrefix = commentPrefix;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.command.ICommand#execute(java.lang.String[]) */
|
|
||||||
@SuppressWarnings("resource")
|
|
||||||
@Override
|
|
||||||
public void execute(String... args) throws CommandRunException {
|
|
||||||
if (args.length == 0) {
|
|
||||||
throw new CommandRunException(CommandRunExceptionType.USAGE,
|
|
||||||
"Expecting a file", this); //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
String scriptFile = args[0];
|
|
||||||
Object[] params = Arrays.copyOfRange(args, 1, args.length);
|
|
||||||
try (FileReader fReader = new FileReader(new File(scriptFile));
|
|
||||||
BufferedReader reader = new BufferedReader(fReader)) {
|
|
||||||
String cmd;
|
|
||||||
for (int i = 1; i < args.length; i++) {
|
|
||||||
params[i - 1] = args[i];
|
|
||||||
}
|
|
||||||
while ((cmd = reader.readLine()) != null) {
|
|
||||||
if (cmd.startsWith(" ") || cmd.startsWith("\t")) { //$NON-NLS-1$ //$NON-NLS-2$
|
|
||||||
reader.close();
|
|
||||||
fReader.close();
|
|
||||||
throw new CommandRunException(
|
|
||||||
"Invalid command in script (line starts with space character)", //$NON-NLS-1$
|
|
||||||
this);
|
|
||||||
}
|
|
||||||
if (cmd.isEmpty() || cmd.startsWith(commentPrefix)) {
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
String cmdLine = MessageFormat.format(cmd, params);
|
|
||||||
List<String> ps = GCLCConstants.splitCommand(cmdLine);
|
|
||||||
String command = ps.remove(0);
|
|
||||||
application.executeSub(command, ps.toArray(new String[0]));
|
|
||||||
}
|
|
||||||
} catch (CommandParsingException e) {
|
|
||||||
throw new CommandRunException("Invalid command in script (" + //$NON-NLS-1$
|
|
||||||
e.getLocalizedMessage() + ")", //$NON-NLS-1$
|
|
||||||
e, this);
|
|
||||||
} catch (IOException e) {
|
|
||||||
throw new CommandRunException(
|
|
||||||
"Unable to read script (" + e.getLocalizedMessage() + ")", //$NON-NLS-1$ //$NON-NLS-2$
|
|
||||||
e, this);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.command.Command#usageDetail() */
|
|
||||||
@Override
|
|
||||||
protected String usageDetail() {
|
|
||||||
StringBuilder builder = new StringBuilder();
|
|
||||||
builder.append(
|
|
||||||
" scriptfile: path to the file containing the script to execute."); //$NON-NLS-1$
|
|
||||||
builder.append(System.lineSeparator());
|
|
||||||
builder.append(System.lineSeparator());
|
|
||||||
builder.append(
|
|
||||||
" The script file must contain one line commands. The lines must never"); //$NON-NLS-1$
|
|
||||||
builder.append(System.lineSeparator());
|
|
||||||
builder.append(
|
|
||||||
"start with whitespace characters. The lines starting with"); //$NON-NLS-1$
|
|
||||||
builder.append(System.lineSeparator());
|
|
||||||
builder.append("\"" + commentPrefix + //$NON-NLS-1$
|
|
||||||
"\" will be ignored as well as empty lines."); //$NON-NLS-1$
|
|
||||||
builder.append(System.lineSeparator());
|
|
||||||
|
|
||||||
return builder.toString();
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.command.ICommand#tip() */
|
|
||||||
@Override
|
|
||||||
public String tip() {
|
|
||||||
return "Execute a script"; //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
@@ -1,194 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright Bigeon Emmanuel (2014)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* provide a generic framework for console applications.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
/** gclc:fr.bigeon.gclc.command.SubedCommand.java
|
|
||||||
* Created on: Sep 6, 2014 */
|
|
||||||
package fr.bigeon.gclc.command;
|
|
||||||
|
|
||||||
import java.io.IOException;
|
|
||||||
import java.util.Arrays;
|
|
||||||
|
|
||||||
import fr.bigeon.gclc.exception.CommandRunException;
|
|
||||||
import fr.bigeon.gclc.exception.CommandRunExceptionType;
|
|
||||||
import fr.bigeon.gclc.exception.InvalidCommandName;
|
|
||||||
import fr.bigeon.gclc.manager.ConsoleManager;
|
|
||||||
|
|
||||||
/** <p>
|
|
||||||
* A subed command is a command that can execute sub commands depending on the
|
|
||||||
* first argument.
|
|
||||||
*
|
|
||||||
* @author Emmanuel BIGEON */
|
|
||||||
public class SubedCommand implements ICommandProvider, ICommand {
|
|
||||||
|
|
||||||
/** The tab character */
|
|
||||||
private static final String TAB = "\t"; //$NON-NLS-1$
|
|
||||||
/** <p>
|
|
||||||
* The command to execute when this command is called with no sub arguments.
|
|
||||||
* This may be null, in which case the command should have arguments. */
|
|
||||||
private final ICommand noArgCommand;
|
|
||||||
/** A tip on this command. */
|
|
||||||
private final String tip;
|
|
||||||
/** The provider */
|
|
||||||
private final CommandProvider provider;
|
|
||||||
/** The name of the command */
|
|
||||||
private final String name;
|
|
||||||
|
|
||||||
/** @param name the name of the command */
|
|
||||||
public SubedCommand(String name) {
|
|
||||||
this.name = name;
|
|
||||||
provider = new CommandProvider();
|
|
||||||
noArgCommand = null;
|
|
||||||
tip = null;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param name the name of the command
|
|
||||||
* @param noArgCommand the command to execute when no extra parameter are
|
|
||||||
* provided */
|
|
||||||
public SubedCommand(String name, ICommand noArgCommand) {
|
|
||||||
this.name = name;
|
|
||||||
provider = new CommandProvider();
|
|
||||||
this.noArgCommand = noArgCommand;
|
|
||||||
tip = null;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param name the name of the command
|
|
||||||
* @param noArgCommand the command to execute
|
|
||||||
* @param tip the help tip associated */
|
|
||||||
public SubedCommand(String name, ICommand noArgCommand,
|
|
||||||
String tip) {
|
|
||||||
this.name = name;
|
|
||||||
provider = new CommandProvider();
|
|
||||||
this.noArgCommand = noArgCommand;
|
|
||||||
this.tip = tip;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param name the name of the command
|
|
||||||
* @param tip the help tip associated */
|
|
||||||
public SubedCommand(String name, String tip) {
|
|
||||||
this.name = name;
|
|
||||||
provider = new CommandProvider();
|
|
||||||
noArgCommand = null;
|
|
||||||
this.tip = tip;
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public boolean add(ICommand value) throws InvalidCommandName {
|
|
||||||
return provider.add(value);
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.acide.Command#execute(java.lang.String[]) */
|
|
||||||
@Override
|
|
||||||
public void execute(String... args) throws CommandRunException {
|
|
||||||
if (args.length == 0 || args[0].startsWith("-")) { //$NON-NLS-1$
|
|
||||||
if (noArgCommand != null) {
|
|
||||||
noArgCommand.execute(args);
|
|
||||||
} else {
|
|
||||||
throw new CommandRunException("Unrecognized command", this); //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
|
|
||||||
try {
|
|
||||||
executeSub(args[0], Arrays.copyOfRange(args, 1, args.length));
|
|
||||||
} catch (CommandRunException e) {
|
|
||||||
throw new CommandRunException(CommandRunExceptionType.USAGE,
|
|
||||||
e.getLocalizedMessage(), e, this);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see
|
|
||||||
* fr.bigeon.gclc.command.ICommandProvider#executeSub(java.lang.String,
|
|
||||||
* java.lang.String[]) */
|
|
||||||
@Override
|
|
||||||
public void executeSub(String command,
|
|
||||||
String... args) throws CommandRunException {
|
|
||||||
provider.executeSub(command, args);
|
|
||||||
}
|
|
||||||
|
|
||||||
@Override
|
|
||||||
public ICommand get(String commandName) {
|
|
||||||
return provider.get(commandName);
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.command.ICommand#getCommandName() */
|
|
||||||
@Override
|
|
||||||
public String getCommandName() {
|
|
||||||
return name;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.command.Command#help() */
|
|
||||||
@Override
|
|
||||||
public void help(ConsoleManager manager,
|
|
||||||
String... args) throws IOException {
|
|
||||||
if (args.length != 0 && !args[0].startsWith("-")) { //$NON-NLS-1$
|
|
||||||
// Specific
|
|
||||||
final ICommand c = get(args[0]);
|
|
||||||
if (c != null) {
|
|
||||||
c.help(manager, Arrays.copyOfRange(args, 1, args.length));
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
// Generic
|
|
||||||
if (noArgCommand != null && noArgCommand.tip() != null) {
|
|
||||||
manager.println(TAB + noArgCommand.tip());
|
|
||||||
}
|
|
||||||
for (final ICommand cmd : provider.commands) {
|
|
||||||
if (cmd.tip() == null) {
|
|
||||||
manager.println(TAB + cmd.getCommandName());
|
|
||||||
} else {
|
|
||||||
manager.println(TAB + cmd.getCommandName() + ": " + //$NON-NLS-1$
|
|
||||||
cmd.tip());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.command.Command#tip() */
|
|
||||||
@Override
|
|
||||||
public String tip() {
|
|
||||||
return tip;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see java.lang.Object#toString() */
|
|
||||||
@Override
|
|
||||||
public String toString() {
|
|
||||||
return "SubedCommand " + provider; //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
@@ -1,118 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright Bigeon Emmanuel (2014)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* provide a generic framework for console applications.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
/**
|
|
||||||
* gclc:fr.bigeon.gclc.exception.CommandRunException.java
|
|
||||||
* Created on: Feb 10, 2015
|
|
||||||
*/
|
|
||||||
package fr.bigeon.gclc.exception;
|
|
||||||
|
|
||||||
import fr.bigeon.gclc.command.ICommand;
|
|
||||||
|
|
||||||
/** <p>
|
|
||||||
* An exception thrown when a command failed to run correctly.
|
|
||||||
*
|
|
||||||
* @author Emmanuel BIGEON */
|
|
||||||
public class CommandRunException extends Exception {
|
|
||||||
|
|
||||||
/**
|
|
||||||
*
|
|
||||||
*/
|
|
||||||
private static final long serialVersionUID = 1L;
|
|
||||||
|
|
||||||
/** The type of run exception */
|
|
||||||
private final CommandRunExceptionType type;
|
|
||||||
/** The command that caused the error */
|
|
||||||
private final ICommand source;
|
|
||||||
|
|
||||||
/** @param message a message
|
|
||||||
* @param source the source */
|
|
||||||
public CommandRunException(String message, ICommand source) {
|
|
||||||
super(message);
|
|
||||||
type = CommandRunExceptionType.EXECUTION;
|
|
||||||
this.source = source;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param message a message
|
|
||||||
* @param cause the cause
|
|
||||||
* @param source the source */
|
|
||||||
public CommandRunException(String message, Throwable cause,
|
|
||||||
ICommand source) {
|
|
||||||
super(message, cause);
|
|
||||||
type = CommandRunExceptionType.EXECUTION;
|
|
||||||
this.source = source;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param type the type of exception
|
|
||||||
* @param message the message
|
|
||||||
* @param source the source */
|
|
||||||
public CommandRunException(CommandRunExceptionType type, String message,
|
|
||||||
ICommand source) {
|
|
||||||
super(message);
|
|
||||||
this.type = type;
|
|
||||||
this.source = source;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param type the type of exception
|
|
||||||
* @param message a message
|
|
||||||
* @param cause the cause
|
|
||||||
* @param source the source */
|
|
||||||
public CommandRunException(CommandRunExceptionType type, String message,
|
|
||||||
Throwable cause, ICommand source) {
|
|
||||||
super(message, cause);
|
|
||||||
this.type = type;
|
|
||||||
this.source = source;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see java.lang.Throwable#getLocalizedMessage() */
|
|
||||||
@Override
|
|
||||||
public String getLocalizedMessage() {
|
|
||||||
if (getCause() != null) {
|
|
||||||
return super.getLocalizedMessage() + ": " + //$NON-NLS-1$
|
|
||||||
getCause().getLocalizedMessage();
|
|
||||||
}
|
|
||||||
return super.getLocalizedMessage();
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @return the source */
|
|
||||||
public ICommand getSource() {
|
|
||||||
return source;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @return the type */
|
|
||||||
public CommandRunExceptionType getType() {
|
|
||||||
return type;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,95 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright Bigeon Emmanuel (2014)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* provide a generic framework for console applications.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
/**
|
|
||||||
* gclc:fr.bigeon.gclc.ConsoleManager.java
|
|
||||||
* Created on: Dec 19, 2014
|
|
||||||
*/
|
|
||||||
package fr.bigeon.gclc.manager;
|
|
||||||
|
|
||||||
import java.io.IOException;
|
|
||||||
|
|
||||||
/** <p>
|
|
||||||
* A console manager is in charge of the basic prompts and prints on a console.
|
|
||||||
* <p>
|
|
||||||
* Depending on the implementation, some manager may not support the prompt with
|
|
||||||
* a message, in that case, the usual behavior is to prompt normally.
|
|
||||||
*
|
|
||||||
* @author Emmanuel BIGEON */
|
|
||||||
public interface ConsoleManager {
|
|
||||||
|
|
||||||
/** @return the prompt prefix */
|
|
||||||
String getPrompt();
|
|
||||||
|
|
||||||
/** @param text the message to print (without line break at the end).
|
|
||||||
* @throws IOException if the manager is closed or could not read the
|
|
||||||
* prompt */
|
|
||||||
void print(String text) throws IOException;
|
|
||||||
|
|
||||||
/** Prints an end of line
|
|
||||||
*
|
|
||||||
* @throws IOException if the manager is closed or could not read the
|
|
||||||
* prompt */
|
|
||||||
void println() throws IOException;
|
|
||||||
|
|
||||||
/** @param message the message to print
|
|
||||||
* @throws IOException if the manager is closed or could not read the
|
|
||||||
* prompt */
|
|
||||||
void println(String message) throws IOException;
|
|
||||||
|
|
||||||
/** @return the user inputed string
|
|
||||||
* @throws IOException if the manager is closed or could not read the
|
|
||||||
* prompt */
|
|
||||||
String prompt() throws IOException;
|
|
||||||
|
|
||||||
/** @param message the message to prompt the user
|
|
||||||
* @return the user inputed string
|
|
||||||
* @throws IOException if the manager is closed or could not read the
|
|
||||||
* prompt */
|
|
||||||
String prompt(String message) throws IOException;
|
|
||||||
|
|
||||||
/** <p>
|
|
||||||
* Set a prompting prefix.
|
|
||||||
*
|
|
||||||
* @param prompt the prompt */
|
|
||||||
void setPrompt(String prompt);
|
|
||||||
|
|
||||||
/** Closes the manager.
|
|
||||||
*
|
|
||||||
* @throws IOException if the close raised an exception */
|
|
||||||
void close() throws IOException;
|
|
||||||
|
|
||||||
/** @return if the manager is closed. */
|
|
||||||
boolean isClosed();
|
|
||||||
}
|
|
||||||
@@ -1,168 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright Bigeon Emmanuel (2014)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* provide a generic framework for console applications.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
/**
|
|
||||||
* gclc:fr.bigeon.gclc.system.SystemConsoleManager.java
|
|
||||||
* Created on: Dec 19, 2014
|
|
||||||
*/
|
|
||||||
package fr.bigeon.gclc.manager;
|
|
||||||
|
|
||||||
import java.io.BufferedReader;
|
|
||||||
import java.io.IOException;
|
|
||||||
import java.io.InputStream;
|
|
||||||
import java.io.InputStreamReader;
|
|
||||||
import java.io.PrintStream;
|
|
||||||
import java.util.logging.Level;
|
|
||||||
import java.util.logging.Logger;
|
|
||||||
|
|
||||||
/** A console using the input stream and print stream.
|
|
||||||
* <p>
|
|
||||||
* The default constructor will use the system standart input and output.
|
|
||||||
*
|
|
||||||
* @author Emmanuel BIGEON */
|
|
||||||
public class SystemConsoleManager implements ConsoleManager { // NOSONAR
|
|
||||||
|
|
||||||
/** The default prompt */
|
|
||||||
public static final String DEFAULT_PROMPT = ">"; //$NON-NLS-1$
|
|
||||||
|
|
||||||
/** The logger */
|
|
||||||
private static final Logger LOGGER = Logger
|
|
||||||
.getLogger(SystemConsoleManager.class.getName());
|
|
||||||
|
|
||||||
/** The command prompt. It can be changed. */
|
|
||||||
private String prompt = DEFAULT_PROMPT;
|
|
||||||
|
|
||||||
/** The print stream */
|
|
||||||
private final PrintStream out;
|
|
||||||
/** The input stream */
|
|
||||||
private final BufferedReader in;
|
|
||||||
|
|
||||||
/** If the manager is closed */
|
|
||||||
private boolean closed = false;
|
|
||||||
|
|
||||||
/** This default constructor relies on the system defined standart output
|
|
||||||
* and input stream. */
|
|
||||||
public SystemConsoleManager() {
|
|
||||||
this(System.out, System.in);
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param out the output stream
|
|
||||||
* @param in the input stream */
|
|
||||||
public SystemConsoleManager(PrintStream out, InputStream in) {
|
|
||||||
super();
|
|
||||||
this.out = out;
|
|
||||||
this.in = new BufferedReader(new InputStreamReader(in));
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @return the prompt */
|
|
||||||
@Override
|
|
||||||
public String getPrompt() {
|
|
||||||
return prompt;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.ConsoleManager#print(java.lang.Object) */
|
|
||||||
@Override
|
|
||||||
public void print(String object) throws IOException {
|
|
||||||
if (closed) {
|
|
||||||
throw new IOException();
|
|
||||||
}
|
|
||||||
out.print(object);
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.ConsoleManager#println() */
|
|
||||||
@Override
|
|
||||||
public void println() throws IOException {
|
|
||||||
if (closed) {
|
|
||||||
throw new IOException();
|
|
||||||
}
|
|
||||||
out.println();
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.ConsoleManager#println(java.lang.Object) */
|
|
||||||
@Override
|
|
||||||
public void println(String object) throws IOException {
|
|
||||||
if (closed) {
|
|
||||||
throw new IOException();
|
|
||||||
}
|
|
||||||
out.println(object);
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.ConsoleManager#prompt() */
|
|
||||||
@Override
|
|
||||||
public String prompt() throws IOException {
|
|
||||||
return prompt(new String() + prompt);
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.ConsoleManager#prompt(java.lang.String) */
|
|
||||||
@Override
|
|
||||||
public String prompt(String message) throws IOException {
|
|
||||||
if (closed) {
|
|
||||||
throw new IOException();
|
|
||||||
}
|
|
||||||
String result = new String();
|
|
||||||
out.print(message + ' ');
|
|
||||||
try {
|
|
||||||
result = in.readLine();
|
|
||||||
} catch (final IOException e) {
|
|
||||||
LOGGER.log(Level.SEVERE, "Unable to read prompt", e); //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
return result;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param prompt the prompt to set */
|
|
||||||
@Override
|
|
||||||
public void setPrompt(String prompt) {
|
|
||||||
this.prompt = prompt;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.manager.ConsoleManager#close() */
|
|
||||||
@Override
|
|
||||||
public void close() throws IOException {
|
|
||||||
closed = true;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* (non-Javadoc)
|
|
||||||
* @see fr.bigeon.gclc.manager.ConsoleManager#isClosed() */
|
|
||||||
@Override
|
|
||||||
public boolean isClosed() {
|
|
||||||
return closed;
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
@@ -1,447 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright Bigeon Emmanuel (2014)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* provide a generic framework for console applications.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
/** acide:fr.bigeon.acide.tool.CLIPrompter.java
|
|
||||||
* Created on: Jul 31, 2014 */
|
|
||||||
package fr.bigeon.gclc.prompt;
|
|
||||||
|
|
||||||
import java.io.IOException;
|
|
||||||
import java.util.ArrayList;
|
|
||||||
import java.util.List;
|
|
||||||
import java.util.Map;
|
|
||||||
import java.util.logging.Level;
|
|
||||||
import java.util.logging.Logger;
|
|
||||||
|
|
||||||
import fr.bigeon.gclc.manager.ConsoleManager;
|
|
||||||
|
|
||||||
/** <p>
|
|
||||||
* The {@link CLIPrompter} class is a utility class that provides method to
|
|
||||||
* prompt the user.
|
|
||||||
*
|
|
||||||
* @author Emmanuel BIGEON */
|
|
||||||
public class CLIPrompter {
|
|
||||||
|
|
||||||
/** message key for format error in prompting a choice */
|
|
||||||
private static final String PROMPTCHOICE_FORMATERR = "promptchoice.formaterr"; //$NON-NLS-1$
|
|
||||||
/** message key for out of bound error in prompting a choice */
|
|
||||||
private static final String PROMPTCHOICE_OUTOFBOUNDS = "promptchoice.outofbounds"; //$NON-NLS-1$
|
|
||||||
/** message key for first form of no in prompting a choice */
|
|
||||||
private static final String PROMPTBOOL_CHOICES_NO1 = "promptbool.choices.no1"; //$NON-NLS-1$
|
|
||||||
/** message key for first form of yes in prompting a choice */
|
|
||||||
private static final String PROMPTBOOL_CHOICES_YES1 = "promptbool.choices.yes1"; //$NON-NLS-1$
|
|
||||||
@SuppressWarnings("javadoc")
|
|
||||||
private static final String BOOL_CHOICES = "promptbool.choices"; //$NON-NLS-1$
|
|
||||||
@SuppressWarnings("javadoc")
|
|
||||||
private static final String LIST_DISP_KEY = "promptlist.exit.dispkey"; //$NON-NLS-1$
|
|
||||||
@SuppressWarnings("javadoc")
|
|
||||||
private static final String PROMPT = "prompt.lineprompt"; //$NON-NLS-1$
|
|
||||||
@SuppressWarnings("javadoc")
|
|
||||||
private static final String LIST_CHOICE_SEP = "promptlist.multi.sepkey"; //$NON-NLS-1$
|
|
||||||
/** The class logger */
|
|
||||||
private static final Logger LOGGER = Logger
|
|
||||||
.getLogger(CLIPrompter.class.getName());
|
|
||||||
|
|
||||||
/** Utility class */
|
|
||||||
private CLIPrompter() {
|
|
||||||
// Utility class
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param manager the manager
|
|
||||||
* @param choices the choices
|
|
||||||
* @param cancel the cancel option if it exists
|
|
||||||
* @return the number of choices plus one (or the number of choices if there
|
|
||||||
* is a cancel)
|
|
||||||
* @throws IOException if the manager was closed */
|
|
||||||
private static <U> int listChoices(ConsoleManager manager, List<U> choices,
|
|
||||||
String cancel) throws IOException {
|
|
||||||
int index = 0;
|
|
||||||
for (final U u : choices) {
|
|
||||||
manager.println(index++ + ") " + u); //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
if (cancel != null) {
|
|
||||||
manager.println(index + ") " + cancel); //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
return index;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param manager the manager
|
|
||||||
* @param message the prompting message
|
|
||||||
* @return the choice
|
|
||||||
* @throws IOException if the manager was closed */
|
|
||||||
public static boolean promptBoolean(ConsoleManager manager,
|
|
||||||
String message) throws IOException {
|
|
||||||
String result = manager
|
|
||||||
.prompt(message + CLIPrompterMessages.getString(BOOL_CHOICES));
|
|
||||||
boolean first = true;
|
|
||||||
final String choices = CLIPrompterMessages
|
|
||||||
.getString(PROMPTBOOL_CHOICES_YES1) + ", " + //$NON-NLS-1$
|
|
||||||
CLIPrompterMessages
|
|
||||||
.getString(PROMPTBOOL_CHOICES_NO1);
|
|
||||||
while (!(result.equalsIgnoreCase(
|
|
||||||
CLIPrompterMessages.getString(PROMPTBOOL_CHOICES_YES1)) ||
|
|
||||||
CLIPrompterMessages.getString(PROMPTBOOL_CHOICES_NO1)
|
|
||||||
.equalsIgnoreCase(result) ||
|
|
||||||
CLIPrompterMessages.getString("promptbool.choices.no2") //$NON-NLS-1$
|
|
||||||
.equalsIgnoreCase(result) ||
|
|
||||||
CLIPrompterMessages.getString("promptbool.choices.yes2") //$NON-NLS-1$
|
|
||||||
.equalsIgnoreCase(result))) {
|
|
||||||
if (!first) {
|
|
||||||
|
|
||||||
manager.println(CLIPrompterMessages
|
|
||||||
.getString("promptbool.choices.invalid", choices)); //$NON-NLS-1$
|
|
||||||
result = manager.prompt(
|
|
||||||
message + CLIPrompterMessages.getString(BOOL_CHOICES));
|
|
||||||
}
|
|
||||||
first = false;
|
|
||||||
}
|
|
||||||
return result.equalsIgnoreCase(
|
|
||||||
CLIPrompterMessages.getString(PROMPTBOOL_CHOICES_YES1)) ||
|
|
||||||
result.equalsIgnoreCase(CLIPrompterMessages
|
|
||||||
.getString("promptbool.choices.yes2")); //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param manager the manager
|
|
||||||
* @param keys the keys to be printed
|
|
||||||
* @param choices the real choices
|
|
||||||
* @param message the message
|
|
||||||
* @param cancel the cancel option, or null
|
|
||||||
* @param <U> the type of elements
|
|
||||||
* @return the choice
|
|
||||||
* @throws IOException if the manager was closed */
|
|
||||||
@SuppressWarnings("boxing")
|
|
||||||
public static <U> U promptChoice(ConsoleManager manager, List<String> keys,
|
|
||||||
List<U> choices, String message,
|
|
||||||
String cancel) throws IOException {
|
|
||||||
final Integer index = promptChoice(manager, keys, message, cancel);
|
|
||||||
if (index == null) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
return choices.get(index);
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param manager the manager
|
|
||||||
* @param <U> The choices labels type
|
|
||||||
* @param <T> The real choices objects
|
|
||||||
* @param choices the list of labels (in order to be displayed)
|
|
||||||
* @param choicesMap the map of label to actual objects
|
|
||||||
* @param message the prompting message
|
|
||||||
* @param cancel the cancel option if it exists (null otherwise)
|
|
||||||
* @return the chosen object
|
|
||||||
* @throws IOException if the manager was closed */
|
|
||||||
public static <U, T> T promptChoice(ConsoleManager manager, List<U> choices,
|
|
||||||
Map<U, T> choicesMap, String message,
|
|
||||||
String cancel) throws IOException {
|
|
||||||
return choicesMap.get(choices.get(
|
|
||||||
promptChoice(manager, choices, message, cancel).intValue()));
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param manager the manager
|
|
||||||
* @param <U> the type of choices
|
|
||||||
* @param choices the list of choices
|
|
||||||
* @param message the prompting message
|
|
||||||
* @param cancel the cancel option, or null
|
|
||||||
* @return the index of the choice
|
|
||||||
* @throws IOException if the manager was closed */
|
|
||||||
@SuppressWarnings("boxing")
|
|
||||||
public static <U> Integer promptChoice(ConsoleManager manager,
|
|
||||||
List<U> choices, String message,
|
|
||||||
String cancel) throws IOException {
|
|
||||||
manager.println(message);
|
|
||||||
final int index = listChoices(manager, choices, cancel);
|
|
||||||
String result = ""; //$NON-NLS-1$
|
|
||||||
boolean keepOn = true;
|
|
||||||
int r = -1;
|
|
||||||
while (keepOn) {
|
|
||||||
result = manager.prompt(CLIPrompterMessages.getString(PROMPT));
|
|
||||||
try {
|
|
||||||
r = Integer.parseInt(result);
|
|
||||||
if (r >= 0 && r <= index) {
|
|
||||||
keepOn = false;
|
|
||||||
} else {
|
|
||||||
manager.println(CLIPrompterMessages
|
|
||||||
.getString(PROMPTCHOICE_OUTOFBOUNDS, 0, index));
|
|
||||||
listChoices(manager, choices, cancel);
|
|
||||||
}
|
|
||||||
|
|
||||||
} catch (final NumberFormatException e) {
|
|
||||||
keepOn = true;
|
|
||||||
manager.println(CLIPrompterMessages
|
|
||||||
.getString(PROMPTCHOICE_FORMATERR, 0, index));
|
|
||||||
listChoices(manager, choices, cancel);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if (r == index && cancel != null) {
|
|
||||||
return null;
|
|
||||||
}
|
|
||||||
return r;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param manager the manager
|
|
||||||
* @param <U> The choices labels type
|
|
||||||
* @param <T> The real choices objects
|
|
||||||
* @param choicesMap the map of label to actual objects
|
|
||||||
* @param message the prompting message
|
|
||||||
* @param cancel the cancel option (or null)
|
|
||||||
* @return the chosen object
|
|
||||||
* @throws IOException if the manager was closed */
|
|
||||||
public static <U, T> T promptChoice(ConsoleManager manager,
|
|
||||||
Map<U, T> choicesMap, String message,
|
|
||||||
String cancel) throws IOException {
|
|
||||||
return promptChoice(manager, new ArrayList<>(choicesMap.keySet()),
|
|
||||||
choicesMap, message, cancel);
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param manager the manager
|
|
||||||
* @param message the prompt message
|
|
||||||
* @return the integer
|
|
||||||
* @throws IOException if the manager was closed */
|
|
||||||
public static int promptInteger(ConsoleManager manager,
|
|
||||||
String message) throws IOException {
|
|
||||||
boolean still = true;
|
|
||||||
int r = 0;
|
|
||||||
while (still) {
|
|
||||||
final String result = manager.prompt(message);
|
|
||||||
try {
|
|
||||||
if (result.isEmpty()) {
|
|
||||||
still = true;
|
|
||||||
continue;
|
|
||||||
}
|
|
||||||
r = Integer.parseInt(result);
|
|
||||||
still = false;
|
|
||||||
} catch (final NumberFormatException e) {
|
|
||||||
LOGGER.log(Level.INFO,
|
|
||||||
"User input a non parsable integer: " + result, e); //$NON-NLS-1$
|
|
||||||
still = true;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return r;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** This methods prompt the user for a list of elements
|
|
||||||
*
|
|
||||||
* @param manager the manager
|
|
||||||
* @param message the message
|
|
||||||
* @return the list of user inputs
|
|
||||||
* @throws IOException if the manager was closed */
|
|
||||||
public static List<String> promptList(ConsoleManager manager,
|
|
||||||
String message) throws IOException {
|
|
||||||
return promptList(manager, message,
|
|
||||||
CLIPrompterMessages.getString("promptlist.exit.defaultkey")); //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
|
|
||||||
/** This methods prompt the user for a list of elements
|
|
||||||
*
|
|
||||||
* @param manager the manager
|
|
||||||
* @param message the message
|
|
||||||
* @param ender the ending sequence for the list
|
|
||||||
* @return the list of user inputs
|
|
||||||
* @throws IOException if the manager was closed */
|
|
||||||
public static List<String> promptList(ConsoleManager manager,
|
|
||||||
String message,
|
|
||||||
String ender) throws IOException {
|
|
||||||
final List<String> strings = new ArrayList<>();
|
|
||||||
manager.println(
|
|
||||||
message + CLIPrompterMessages.getString(LIST_DISP_KEY, ender));
|
|
||||||
String res = null;
|
|
||||||
while (!ender.equals(res)) {
|
|
||||||
res = manager.prompt(CLIPrompterMessages.getString(PROMPT));
|
|
||||||
if (!res.equals(ender)) {
|
|
||||||
strings.add(res);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return strings;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Prompt for a text with several lines.
|
|
||||||
*
|
|
||||||
* @param manager the manager
|
|
||||||
* @param message the prompting message
|
|
||||||
* @return the text
|
|
||||||
* @throws IOException if the manager was closed */
|
|
||||||
public static String promptLongText(ConsoleManager manager,
|
|
||||||
String message) throws IOException {
|
|
||||||
return promptLongText(manager, message, CLIPrompterMessages
|
|
||||||
.getString("promptlongtext.exit.defaultkey")); //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Prompt for a text with several lines.
|
|
||||||
*
|
|
||||||
* @param manager the manager
|
|
||||||
* @param message the prompting message
|
|
||||||
* @param ender the ender character
|
|
||||||
* @return the text
|
|
||||||
* @throws IOException if the manager was closed */
|
|
||||||
public static String promptLongText(ConsoleManager manager, String message,
|
|
||||||
String ender) throws IOException {
|
|
||||||
manager.println(message + CLIPrompterMessages
|
|
||||||
.getString("promptlongtext.exit.dispkey", ender)); //$NON-NLS-1$
|
|
||||||
String res = manager.prompt(PROMPT);
|
|
||||||
String line = res;
|
|
||||||
while (!line.equals(ender)) {
|
|
||||||
line = manager.prompt(PROMPT);
|
|
||||||
if (!line.equals(ender)) {
|
|
||||||
res += System.lineSeparator() + line;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return res.equals(ender) ? "" : res; //$NON-NLS-1$
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param manager the manager
|
|
||||||
* @param keys the keys to be printed
|
|
||||||
* @param choices the real choices
|
|
||||||
* @param message the message
|
|
||||||
* @param <U> the type of elements
|
|
||||||
* @return the choice
|
|
||||||
* @throws IOException if the manager was closed */
|
|
||||||
public static <U> List<U> promptMultiChoice(ConsoleManager manager,
|
|
||||||
List<String> keys,
|
|
||||||
List<U> choices,
|
|
||||||
String message) throws IOException {
|
|
||||||
final List<Integer> indices = promptMultiChoice(manager, keys, message);
|
|
||||||
final List<U> userChoices = new ArrayList<>();
|
|
||||||
for (final Integer integer : indices) {
|
|
||||||
userChoices.add(choices.get(integer.intValue()));
|
|
||||||
}
|
|
||||||
return userChoices;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param manager the manager
|
|
||||||
* @param <U> The choices labels type
|
|
||||||
* @param <T> The real choices objects
|
|
||||||
* @param choices the list of labels (in order to be displayed)
|
|
||||||
* @param choicesMap the map of label to actual objects
|
|
||||||
* @param message the prompting message
|
|
||||||
* @return the chosen objects (or an empty list)
|
|
||||||
* @throws IOException if the manager was closed */
|
|
||||||
public static <U, T> List<T> promptMultiChoice(ConsoleManager manager,
|
|
||||||
List<U> choices,
|
|
||||||
Map<U, T> choicesMap,
|
|
||||||
String message) throws IOException {
|
|
||||||
final List<Integer> chs = promptMultiChoice(manager, choices, message);
|
|
||||||
final List<T> userChoices = new ArrayList<>();
|
|
||||||
for (final Integer integer : chs) {
|
|
||||||
userChoices.add(choicesMap.get(integer));
|
|
||||||
}
|
|
||||||
return userChoices;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param manager the manager
|
|
||||||
* @param <U> the type of choices
|
|
||||||
* @param choices the list of choices
|
|
||||||
* @param message the prompting message
|
|
||||||
* @return the indices of the choices
|
|
||||||
* @throws IOException if the manager was closed */
|
|
||||||
@SuppressWarnings("boxing")
|
|
||||||
public static <U> List<Integer> promptMultiChoice(ConsoleManager manager,
|
|
||||||
List<U> choices,
|
|
||||||
String message) throws IOException {
|
|
||||||
manager.println(message);
|
|
||||||
final int index = listChoices(manager, choices, null);
|
|
||||||
String result = ""; //$NON-NLS-1$
|
|
||||||
boolean keepOn = true;
|
|
||||||
final List<Integer> chs = new ArrayList<>();
|
|
||||||
while (keepOn) {
|
|
||||||
keepOn = false;
|
|
||||||
result = manager.prompt(CLIPrompterMessages.getString(PROMPT));
|
|
||||||
final String[] vals = result
|
|
||||||
.split(CLIPrompterMessages.getString(LIST_CHOICE_SEP));
|
|
||||||
for (final String val : vals) {
|
|
||||||
boolean added;
|
|
||||||
try {
|
|
||||||
added = addUserChoice(val, chs, index);
|
|
||||||
} catch (final NumberFormatException e) {
|
|
||||||
keepOn = true;
|
|
||||||
manager.println(CLIPrompterMessages
|
|
||||||
.getString(PROMPTCHOICE_FORMATERR, 0, index));
|
|
||||||
listChoices(manager, choices, null);
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
if (!added) {
|
|
||||||
manager.println(CLIPrompterMessages
|
|
||||||
.getString(PROMPTCHOICE_OUTOFBOUNDS, 0, index));
|
|
||||||
listChoices(manager, choices, null);
|
|
||||||
keepOn = true;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return chs;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param val the string to parse
|
|
||||||
* @param chs the list of integers
|
|
||||||
* @param index the max index of choice
|
|
||||||
* @return if the parsing was done correctly */
|
|
||||||
private static boolean addUserChoice(String val, List<Integer> chs,
|
|
||||||
int index) {
|
|
||||||
if (val.isEmpty()) {
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
final int r;
|
|
||||||
r = Integer.parseInt(val);
|
|
||||||
if (r >= 0 && r < index) {
|
|
||||||
chs.add(Integer.valueOf(r));
|
|
||||||
return true;
|
|
||||||
}
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param manager the manager
|
|
||||||
* @param <U> The choices labels type
|
|
||||||
* @param <T> The real choices objects
|
|
||||||
* @param choicesMap the map of label to actual objects
|
|
||||||
* @param message the prompting message
|
|
||||||
* @return the chosen objects
|
|
||||||
* @throws IOException if the manager was closed */
|
|
||||||
public static <U, T> List<T> promptMultiChoice(ConsoleManager manager,
|
|
||||||
Map<U, T> choicesMap,
|
|
||||||
String message) throws IOException {
|
|
||||||
return promptMultiChoice(manager, new ArrayList<>(choicesMap.keySet()),
|
|
||||||
choicesMap, message);
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param manager the manager
|
|
||||||
* @param prompt the prompting message
|
|
||||||
* @param reprompt the prompting message after empty input
|
|
||||||
* @return the non empty input
|
|
||||||
* @throws IOException if the manager was closed */
|
|
||||||
public static String promptNonEmpty(ConsoleManager manager, String prompt,
|
|
||||||
String reprompt) throws IOException {
|
|
||||||
String res = manager.prompt(prompt);
|
|
||||||
while (res.isEmpty()) {
|
|
||||||
res = manager.prompt(reprompt);
|
|
||||||
}
|
|
||||||
return res;
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
@@ -1,108 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright Bigeon Emmanuel (2014)
|
|
||||||
*
|
|
||||||
* emmanuel@bigeon.fr
|
|
||||||
*
|
|
||||||
* This software is a computer program whose purpose is to
|
|
||||||
* provide a generic framework for console applications.
|
|
||||||
*
|
|
||||||
* This software is governed by the CeCILL license under French law and
|
|
||||||
* abiding by the rules of distribution of free software. You can use,
|
|
||||||
* modify and/or redistribute the software under the terms of the CeCILL
|
|
||||||
* license as circulated by CEA, CNRS and INRIA at the following URL
|
|
||||||
* "http://www.cecill.info".
|
|
||||||
*
|
|
||||||
* As a counterpart to the access to the source code and rights to copy,
|
|
||||||
* modify and redistribute granted by the license, users are provided only
|
|
||||||
* with a limited warranty and the software's author, the holder of the
|
|
||||||
* economic rights, and the successive licensors have only limited
|
|
||||||
* liability.
|
|
||||||
*
|
|
||||||
* In this respect, the user's attention is drawn to the risks associated
|
|
||||||
* with loading, using, modifying and/or developing or reproducing the
|
|
||||||
* software by the user in light of its specific status of free software,
|
|
||||||
* that may mean that it is complicated to manipulate, and that also
|
|
||||||
* therefore means that it is reserved for developers and experienced
|
|
||||||
* professionals having in-depth computer knowledge. Users are therefore
|
|
||||||
* encouraged to load and test the software's suitability as regards their
|
|
||||||
* requirements in conditions enabling the security of their systems and/or
|
|
||||||
* data to be ensured and, more generally, to use and operate it in the
|
|
||||||
* same conditions as regards security.
|
|
||||||
*
|
|
||||||
* The fact that you are presently reading this means that you have had
|
|
||||||
* knowledge of the CeCILL license and that you accept its terms.
|
|
||||||
*/
|
|
||||||
/**
|
|
||||||
* acide:fr.bigeon.acide.tools.PrintUtils.java
|
|
||||||
* Created on: Jan 20, 2015
|
|
||||||
*/
|
|
||||||
package fr.bigeon.gclc.tools;
|
|
||||||
|
|
||||||
import java.util.ArrayList;
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
/** A tool class for printing text in a console.
|
|
||||||
*
|
|
||||||
* @author Emmanuel BIGEON */
|
|
||||||
public class PrintUtils {
|
|
||||||
|
|
||||||
/** The continuation dot string */
|
|
||||||
private static final String CONT_DOT = "..."; //$NON-NLS-1$
|
|
||||||
/** The continuation dot string length */
|
|
||||||
private static final int CONT_DOT_LENGTH = CONT_DOT.length();
|
|
||||||
|
|
||||||
/** Utility class */
|
|
||||||
private PrintUtils() {
|
|
||||||
// Utility class
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param text the text to print
|
|
||||||
* @param nbCharacters the number of characters of the resulting text
|
|
||||||
* @param indicateTooLong if an indication shell be given that the text
|
|
||||||
* didn't fit
|
|
||||||
* @return the text to print (will be of exactly nbCharacters). */
|
|
||||||
public static String print(String text, int nbCharacters,
|
|
||||||
boolean indicateTooLong) {
|
|
||||||
String res = text;
|
|
||||||
if (res.length() > nbCharacters) {
|
|
||||||
// Cut
|
|
||||||
if (indicateTooLong) {
|
|
||||||
// With suspension dots
|
|
||||||
res = res.substring(0, nbCharacters - CONT_DOT_LENGTH) +
|
|
||||||
CONT_DOT;
|
|
||||||
} else {
|
|
||||||
res = res.substring(0, nbCharacters);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
while (res.length() < nbCharacters) {
|
|
||||||
// Add trailing space
|
|
||||||
res = res + ' ';
|
|
||||||
}
|
|
||||||
return res;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** @param description the element to wrap in lines
|
|
||||||
* @param i the length of the wrap
|
|
||||||
* @return the list of resulting strings */
|
|
||||||
public static List<String> wrap(String description, int i) {
|
|
||||||
final String[] originalLines = description
|
|
||||||
.split(System.lineSeparator());
|
|
||||||
final List<String> result = new ArrayList<>();
|
|
||||||
for (final String string : originalLines) {
|
|
||||||
String toCut = string;
|
|
||||||
while (toCut.length() > i) {
|
|
||||||
int index = toCut.lastIndexOf(" ", i); //$NON-NLS-1$
|
|
||||||
if (index == -1) {
|
|
||||||
result.add(toCut.substring(0, i));
|
|
||||||
index = i - 1;
|
|
||||||
} else {
|
|
||||||
result.add(toCut.substring(0, index));
|
|
||||||
}
|
|
||||||
toCut = toCut.substring(index + 1);
|
|
||||||
}
|
|
||||||
result.add(toCut);
|
|
||||||
result.add(new String());
|
|
||||||
}
|
|
||||||
return result;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user