Diferencias

Muestra las diferencias entre dos versiones de la página.

--- bloque5:documentacion [2021/02/05 02:10] – [Documentación en PDF] fernando
+++ bloque5:documentacion [2024/09/16 20:55] (actual) – editor externo 127.0.0.1
@@ Línea 101: / Línea 101: @@
   * ''@return'': indicando el tipo y su funcionalidad, si el método no es void
   * ''@exception ó @throws'': una por tipo de Exception que se puede lanzar, solo si se lanzan (@exception y @throws se pueden usar indistintamente).
+==== Generar JavaDoc en IntelliJ ====
+La documentación JavaDoc la podemos almacenar en la ruta que queramos. Puede ser buena idea crear un directorio dentro de nuestro proyecto e indicar que se exporte en esa ubicación.
+En el menú //Tools// pulsamos sobre la opción "//Generate JavaDoc..//" y se nos abre el siguiente dialogo:
+{{ :bloque5:javadoc-intellij.png?direct&300 |}}
+  - Ítem de lista ordenada Indicamos que queremos generar la documentación de todo el proyecto
+  - Indicamos la ruta donde queremos que se genere
+  - Podemos indicar también qué miembros de la clase se tendrán en cuenta para generar el javadoc. Lo habitual es generar la documentación de la API pública. Pero desde el punto de vista del desarrollador, puede ser interesante mostrar la documentación de todos los miembros de la clase, independientemente de su visibilidad. Entonces podemos subir el //slider// a **private**, ya que es la visibilidad más restrictiva.
 ==== Diagrama de clases ====
 Un diagrama de clases nos ayuda a tener un enfoque de las relaciones entre las clases que conforman un programa.
@@ Línea 110: / Línea 120: @@
 No está de más incluirlo en la documentación de nuestra aplicación.
+  * **Generar Diagrama de clases en IntelliJ**: Necesitamos seleccionar el //package// que contiene las clases de nuestro programa, y pulsar botón derecho sobre la selección -> Diagram -> Show Diagram. Después podemos indicar qué elementos queremos que se muestren en nuestro diagrama, así como si queremos que se muestren las relaciones.
 ===== Manual de Usuario =====
@@ Línea 171: / Línea 183: @@
 Un generador de instaladores es un programa que contiene una serie de pasos a través de los cuales copia nuestra aplicación y los ficheros necesario dentro de un directorio en nuestro equipo. A estos programas les indicaremos todos los ficheros que queremos copiar en el equipo destino y la ruta donde debe copiarlos.
-Además de lo indicado anteriormente, los estos programas nos permiten añadir multitud de opciones: mostrar licencias, crear accesos directos, crear accesos en el menu inicio de Windows, etc. Normalmente estos programas permiten que configuremos todas las opciones que va a tener nuestro isntalador mediante un lenguaje de script.
+Además de lo indicado anteriormente, estos programas nos permiten añadir multitud de opciones: mostrar licencias, crear accesos directos, crear accesos en el menu inicio de Windows, etc. Normalmente permiten que configuremos todas las opciones que va a tener nuestro instalador mediante un lenguaje de script.
-Este tipo de programas tienen su propio lenguaje script para definir todas las opciones que queremos que tenga el isntalador. Algunos de ellos nos permiten crear el script mediante un modo asistido (//Wizard//) de forma que nos facilita la creación sin necesidad de conocer su lenguaje de //scripting//.
+Este tipo de programas tienen su propio lenguaje script para definir todas las opciones que queremos que tenga el instalador. Algunos de ellos nos permiten crear el script mediante un modo asistido (//Wizard//) de forma que nos facilita la creación sin necesidad de conocer su lenguaje de //scripting//.
 A continuación indicamos dos de los programas más famosos:
@@ Línea 190: / Línea 202: @@
 ==== Manual de Instalación ====
-El manual de instalación permite al usuario desplegar la aplicación en el sistema. En algunos casos esta documentación se puede incluir en los diferentes pasos guiados de un isntalador, o sino incluirla en un documento o página web.
+El manual de instalación permite al usuario desplegar la aplicación en el sistema. En algunos casos esta documentación se puede incluir en los diferentes pasos guiados de un instalador, o si no incluirla en un documento o página web.
-Su finalidad es facilitar al usuario la isntalación, sobre todo en caso de que se permita elegir diferentes parámetros de instalación (crear accesos directos, instalar componentes extra, indicar una ruta de instalación, etc).
+Su finalidad es facilitar al usuario la instalación, sobre todo en caso de que se permita elegir diferentes parámetros de instalación (crear accesos directos, instalar componentes extra, indicar una ruta de instalación, etc).
 ==== Licencias ====
 Todo obra de software debe distribuirse bajo los términos de una licencia de software. __La licencia describe el contrato de uso y posesión entre el desarrollador de software y el usuario__. Principalmente existen las licencias de software privativas y las licencias libres. Ambas clasificaciones tienen diversos matices en cuanto a cuanta libertad tiene el usuario final respecto al uso del software. Todos estos matices vienen recogidos en los diferentes tipos de licencias.
@@ Línea 260: / Línea 272: @@
 </code>
+{{ :bloque5:visorweb-jtextpane.png?direct&400 |}}
+Las clases ''JTextPane'' o ''JEditorPane'' aunque permiten visualizar y parsear código //html//, no están diseñadas para tal labor. Las librerías de //JavaFX// tienen componentes específicos para mostrar código //html//.
 Mostrar sitio web con **JavaFX**:
@@ Línea 265: / Línea 280: @@
 <code java>
 JFXPanel fxpanel = new JFXPanel();
+JFrame frame = new JFrame();
+...
 frame.add(fxpanel);
-Platform.runLater(new Runnable() {
+WebEngine engine;
-   @Override
+WebView view  = new WebView();
-   public void run() {
+engine = view.getEngine();
-      WebEngine engine;
+fxpanel.setScene(new Scene(view));
-      WebView view  = new WebView();
+engine.load("http://miSitioWeb.com");
-      engine = view.getEngine();
-      fxpanel.setScene(new Scene(view));
-      engine.load("http://miSitioWeb.com");
-    }
-});
 frame.setVisible(true);
 </code>
+{{ :bloque5:visorweb-javafx.png?direct&400 |}}
 Estos ejemplos están extraidos del sitio [[http://javatongue.blogspot.com/2015/09/how-to-load-webpage-in-java-app.html|javatongue.blogspot.com]]
-==== Documentación en PDF - IcePDF====
+==== Documentación en PDF. Librería IcePDF====
 Ofreciendo la documentación en formato PDF, podemos también mostrarla desde alguna sección de nuestra aplicación, o permitir al programa utilizar la aplicación por defecto del sistema para abrir dicha documentación.
@@ Línea 292: / Línea 306: @@
   * icepdf-viewer.jar: [[https://mvnrepository.com/artifact/org.icepdf.os/icepdf-viewer|Repositorio de maven]]
-El siguiente ejemplos está planteado con las ultimas versiones: [[https://mvnrepository.com/artifact/org.icepdf.os/icepdf-core/6.2.2|icepdf.core-6.2.2.jar]] y [[https://mvnrepository.com/artifact/org.icepdf.os/icepdf-viewer/6.2.2|icepdf-viewer-6.2.2.jar]]
+El siguiente ejemplo está planteado con las últimas versiones en la fecha: [[https://mvnrepository.com/artifact/org.icepdf.os/icepdf-core/6.2.2|icepdf.core-6.2.2.jar]] y [[https://mvnrepository.com/artifact/org.icepdf.os/icepdf-viewer/6.2.2|icepdf-viewer-6.2.2.jar]]
 Necesitamos un JPanel para mostra el visor PDF, que podemos añadir a una ventana específica, o a un area dentro de una ventana.
@@ Línea 314: / Línea 328: @@
 //Finalmente, abrimos el fichero pdf indicando su ruta
 controller.openDocument("miFichero.pdf");
-<code>
+</code>
-{{ :bloque5:icepdf-viewer.png?direct&400|}}
+{{ :bloque5:icepdf-viewer.png?direct&400 | }}
 ----
 (c) {{date> %Y}} Fernando Valdeón