Dateiverwaltung für die WebBox
ulrich
2017-03-14 e3043fddcaf5e3ea4beb022c04d411661a3499bd
commit | author | age
798463 1 # Dateiverwaltung
U 2
fcee96 3 Eine Bedienoberfläche zur Bearbeitung und Verwaltung von Dateien für die [WebBox](/dev/Software/WebBox/WebBox).  
798463 4
U 5 ## Funktionen
6
65ca7a 7 Die Dateiverwaltung besitzt die folgenden Funktionen
798463 8
65ca7a 9 - Persönliches und öffentliches Verzeichnis je Benutzer
680ec1 10 - Auflisten von Verzeichnissen und ihrer Inhalte
U 11 - Ansehen der Datei-Inhalte
12 - Erstellen und Bearbeiten von Texten und Dokumenten
65ca7a 13 - Dateien und Ordner kopieren, verschieben und löschen
680ec1 14 - Hochladen per Drag and Drop direkt in Ordner
U 15 - Listen- und Kachelansicht
798463 16
680ec1 17 Die Bedienoberfläche passt sich an verschiedene Geräteausstattungen an (responsiv). Weitere Informationen zur Dateiverwaltung finden sich auf der [Produktseite](/dev/Software/filecms/Dateiverwaltung).
798463 18
U 19 ## Webanwendung herstellen
20
1ac489 21 Zum Herstellen der Webanwendung wird ein Java Development Kit (JDK) benötigt, wie es z.B. von [Azul](http://azul.com) oder dem [OpenJDK-Projekt](http://openjdk.java.net/) frei erhältlich ist. In der hier folgenden weiteren Beschreibung wird der lokale Ablageort des Java Development Kits `$JDK` genannt.
798463 22
U 23 Desweiteren werden die folgenden Klassenbibliotheken benötigt
24
25 ```
26 Bibliothek            Datei(en)                       Ablageort lokal
27 ----------            ---------                       ---------------
28 Commons Fileupload .. commons-fileupload-1.3.2.jar .. $JLIB
29 Commons IO .......... commons-io-2.5.jar ............ $JLIB
30 Tomcat .............. lib/servlet-api.jar ........... $CATALINA_HOME
31 XStream ............. xstream-1.4.7.jar ............. $JLIB
32 Jettison ............ jettison-1.3.3.jar ............ $JLIB
33 Transit ............. Transit.jar ................... $JLIB
34 ```
35 Diese sind an folgenden Orten frei erhältlich:
36
37 - [Apache Commons](http://commons.apache.org)
38 - [Apache Tomcat](http://tomcat.apache.org)
39 - [XStream](https://github.com/codehaus/xstream)
40 - [Jettison](https://github.com/codehaus/jettison)
2d4415 41 - [Transit](/gitblit/docs/Transit.git)
798463 42
1197b5 43 Nach Beschaffung des JDK und der oben angegebenen Klassenbibliotheken wird der Quellcode aus diesem Git-Repository an einen frei wählbaren lokalen Ablageort [heruntergeladen](http://uhilger.de/gitblit/zip/?r=file-cms.git&h=master&format=zip) und entpackt. In der hier folgenden weiteren Beschreibung wird das so entstandene Verzeichnis `file-cms-master` einschließlich des absoluten Pfades dorthin `$FILE-CMS` genannt. Ferner wird angenommen, dass die oben aufgeführten Klassenbibliotheken lokal an Orten abgelegt sind, deren Pfade mit den Platzhaltern `$JLIB` und `$CATALINA_HOME` gemeint sind. Anstelle der Platzhalter in den folgenden Kommandos muss also der absolute Pfad des lokalen Ablageortes eingesetzt werden.
798463 44
1ac489 45 Zur Herstellung der Dateiverwaltung werden die folgenden Kommandos ausgeführt (Beispiel für Linux):
798463 46
U 47 ```
48 cd $FILE-CMS
49 mkdir dist
50 mkdir build
51 cp -r web/* build
52 cd build/WEB-INF
53 mkdir classes
54 mkdir lib
55 cd ../..
56 cp $JLIB/* build/WEB-INF/lib
57
2b9663 58 $JDK/bin/javac -classpath $JLIB/commons-fileupload-1.3.2.jar:$JLIB/commons-io-2.5.jar:$JLIB/jettison-1.3.3.jar:$JLIB/Transit.jar:$JLIB/xstream-1.4.7.jar:$CATALINA_HOME/lib/servlet-api.jar -d ./build/WEB-INF/classes src/java/de/uhilger/filecms/api/*.java src/java/de/uhilger/filecms/web/*.java src/java/de/uhilger/filecms/pub/*.java
798463 59
30a32f 60 cp src/java/logging.properties build/WEB-INF/classes
798463 61 $JDK/bin/jar -cf dist/file-cms.war -C build .
U 62 rm -r build
63 ```
64
65 Das Webarchiv der Dateiverwaltung liegt anschließend als `$FILE-CMS/dist/file-cms.war` fertig zum Deployment bereit.
66
67 ### Distributionsalternative
68
69 Das Kommando `cp $JLIB/* build/WEB-INF/lib` kann auch weggelassen werden, dann sind die Klassenbibliotheken nicht Teil des Webarchivs der Dateiverwaltung. In diesem Fall muss stattdessen der Inhalt von `$JLIB` nach `$CATALINA_BASE/lib` kopiert werden.
70
71 ## Abhängigkeiten
72
73 Die Dateiverwaltung erfordert die folgenden Bestandteile auf der Instanz von Tomcat, auf der sie ausgeführt werden soll:
74
75 ```
76 $CATALINA_BASE/webapps/jslib/bootstrap ............ mindestens in Version 4.0 alpha 6
77 $CATALINA_BASE/webapps/jslib/jquery ............... mindestens in Version 1.11.1
78 $CATALINA_BASE/webapps/jslib/mustache ............. mindestens in Version 2.3.0
79 $CATALINA_BASE/webapps/jslib/font-awesome ......... mindestens in Version 4.4.0
80 $CATALINA_BASE/webapps/jslib/codemirror ........... mindestens in Version 5.24.2
680ec1 81 $CATALINA_BASE/webapps/jslib/tinymce .............. mindestens in Version 4.3.4
798463 82 ```
U 83
84 `$CATALINA_BASE` meint das in der der Datei [RUNNING.txt](http://tomcat.apache.org/tomcat-8.5-doc/RUNNING.txt) der Tomcat-Dokumentation so bezeichnete Verzeichnis. Nachfolgend die Quellen, von denen die obigen Abhängigkeiten bezogen werden können:
85
86 - [Bootstrap](http://getbootstrap.com)
87 - [jQuery](http://jquery.com)
88 - [Mustache](https://github.com/janl/mustache.js)
89 - [Font Awesome](http://fontawesome.io/)
85053f 90 - [Codemirror](https://codemirror.net)
680ec1 91 - [TinyMCE](https://tinymce.com)
85053f 92
U 93 ## Lizenz
94
db9792 95 Die Dateiverwaltung wird zu den Bedingungen der [GNU Affero General Public License](/gitblit/doc/file-cms.git/master/web!agpl.txt) bereitgestellt. Die von der Dateiverwaltung verwendeten Komponenten unterliegen zum Teil anderen Lizenzen. Deren Nutzungsbedingungen sind an den Quellen der Komponenten angegeben.