aboutsummaryrefslogtreecommitdiff
path: root/poo/nb.lyx
diff options
context:
space:
mode:
authorJuan Marín Noguera <juan.marinn@um.es>2020-02-24 11:22:00 +0100
committerJuan Marín Noguera <juan.marinn@um.es>2020-02-24 11:22:00 +0100
commit79e1a51eb55d0df43323c0fe77a7d55b2c2bd17d (patch)
tree89bd93a329f9deb72efce8fed205b69918c3d9b9 /poo/nb.lyx
parent1f7f9bcc7660fba0827a62c3068d5c7082f025d7 (diff)
POO
Diffstat (limited to 'poo/nb.lyx')
-rw-r--r--poo/nb.lyx743
1 files changed, 743 insertions, 0 deletions
diff --git a/poo/nb.lyx b/poo/nb.lyx
new file mode 100644
index 0000000..19478fe
--- /dev/null
+++ b/poo/nb.lyx
@@ -0,0 +1,743 @@
+#LyX 2.3 created this file. For more info see http://www.lyx.org/
+\lyxformat 544
+\begin_document
+\begin_header
+\save_transient_properties true
+\origin unavailable
+\textclass book
+\use_default_options true
+\maintain_unincluded_children false
+\language spanish
+\language_package default
+\inputencoding auto
+\fontencoding global
+\font_roman "default" "default"
+\font_sans "default" "default"
+\font_typewriter "default" "default"
+\font_math "auto" "auto"
+\font_default_family default
+\use_non_tex_fonts false
+\font_sc false
+\font_osf false
+\font_sf_scale 100 100
+\font_tt_scale 100 100
+\use_microtype false
+\use_dash_ligatures true
+\graphics default
+\default_output_format default
+\output_sync 0
+\bibtex_command default
+\index_command default
+\paperfontsize default
+\spacing single
+\use_hyperref false
+\papersize default
+\use_geometry false
+\use_package amsmath 1
+\use_package amssymb 1
+\use_package cancel 1
+\use_package esint 1
+\use_package mathdots 1
+\use_package mathtools 1
+\use_package mhchem 1
+\use_package stackrel 1
+\use_package stmaryrd 1
+\use_package undertilde 1
+\cite_engine basic
+\cite_engine_type default
+\biblio_style plain
+\use_bibtopic false
+\use_indices false
+\paperorientation portrait
+\suppress_date false
+\justification true
+\use_refstyle 1
+\use_minted 0
+\index Index
+\shortcut idx
+\color #008000
+\end_index
+\secnumdepth 3
+\tocdepth 3
+\paragraph_separation indent
+\paragraph_indentation default
+\is_math_indent 0
+\math_numbering_side default
+\quotes_style french
+\dynamic_quotes 0
+\papercolumns 1
+\papersides 1
+\paperpagestyle default
+\tracking_changes false
+\output_changes false
+\html_math_output 0
+\html_css_as_file 0
+\html_be_strict false
+\end_header
+
+\begin_body
+
+\begin_layout Standard
+En Eclipse, todo el código fuente o compilado se encuentra en un directorio
+ llamado
+\series bold
+espacio de trabajo
+\series default
+.
+ Para importar un proyecto, movemos su directorio al espacio de trabajo
+ y, desde Eclipse, usamos
+\begin_inset Quotes fld
+\end_inset
+
+Archivo
+\begin_inset Formula $\rightarrow$
+\end_inset
+
+Importar
+\begin_inset Formula $\rightarrow$
+\end_inset
+
+General
+\begin_inset Formula $\rightarrow$
+\end_inset
+
+Proyectos existentes en el espacio de trabajo
+\begin_inset Quotes frd
+\end_inset
+
+, donde nos pide el directorio raíz introducimos la ruta del espacio de
+ trabajo, pulsamos
+\begin_inset Quotes fld
+\end_inset
+
+Examinar
+\begin_inset Quotes frd
+\end_inset
+
+ y, en el panel inferior
+\begin_inset Quotes fld
+\end_inset
+
+Proyectos
+\begin_inset Quotes frd
+\end_inset
+
+, seleccionamos el que deseamos importar, y pulsamos
+\begin_inset Quotes fld
+\end_inset
+
+Finalizar
+\begin_inset Quotes frd
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+El código fuente Java se guarda en ficheros
+\family typewriter
+\emph on
+Clase
+\emph default
+.java
+\family default
+ que, al compilarlos, se convierten en ficheros compilados o de
+\emph on
+bytecode
+\emph default
+
+\family typewriter
+\emph on
+Clase
+\emph default
+.class
+\family default
+, uno por clase.
+ Para ejecutar un programa usamos el comando
+\family typewriter
+java [
+\emph on
+OPCIÓN
+\emph default
+]...
+
+\emph on
+CLASE
+\family default
+\emph default
+, donde
+\family typewriter
+\emph on
+CLASE
+\family default
+\emph default
+ es la ruta completa de la clase principal.
+ Las clases se buscan según un
+\emph on
+classpath
+\emph default
+, una lista de directorios (o ficheros com
+\begin_inset ERT
+status open
+
+\begin_layout Plain Layout
+
+
+\backslash
+-
+\end_layout
+
+\end_inset
+
+pri
+\begin_inset ERT
+status open
+
+\begin_layout Plain Layout
+
+
+\backslash
+-
+\end_layout
+
+\end_inset
+
+mi
+\begin_inset ERT
+status open
+
+\begin_layout Plain Layout
+
+
+\backslash
+-
+\end_layout
+
+\end_inset
+
+dos) separados por
+\family typewriter
+;
+\family default
+, de forma que en uno de ellos debe haber un fichero de
+\emph on
+bytecode
+\emph default
+ cuya ruta relativa al directorio debe ser el resultado de cambiar los separador
+es
+\family typewriter
+.
+
+\family default
+ en la ruta completa de la clase por
+\family typewriter
+/
+\family default
+ y añadir al final la extensión
+\family typewriter
+.class
+\family default
+.
+ El
+\emph on
+classpath
+\emph default
+ se indica al comando con la opción
+\family typewriter
+-cp
+\emph on
+CLASSPATH
+\family default
+\emph default
+; si no aparece, se toma de la variable de entorno
+\family typewriter
+CLASSPATH
+\family default
+, y si esta tampoco existe, se asume que es
+\begin_inset Quotes fld
+\end_inset
+
+
+\family typewriter
+.
+\family default
+
+\begin_inset Quotes frd
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+Un fichero JAR es un comprimido con extensión (normalmente)
+\family typewriter
+.jar
+\family default
+ que contiene los ficheros compilados y un
+\series bold
+manifiesto
+\series default
+ que describe el contenido.
+ El manifiesto se encuentra en
+\family typewriter
+META-INF/MANIFEST.MF
+\family default
+ dentro del comprimido, y suele tener el siguiente aspecto:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Box Frameless
+position "t"
+hor_pos "c"
+has_inner_box 1
+inner_pos "t"
+use_parbox 0
+use_makebox 0
+width "100col%"
+special "none"
+height "1in"
+height_special "totalheight"
+thickness "0.4pt"
+separation "3pt"
+shadowsize "4pt"
+framecolor "black"
+backgroundcolor "none"
+status open
+
+\begin_layout Plain Layout
+
+\family typewriter
+Class-Path:
+\emph on
+ELEMENTO
+\emph default
+
+\family default
+...
+\end_layout
+
+\begin_layout Plain Layout
+
+\family typewriter
+Main-Class:
+\emph on
+RUTA_CLASE
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Donde la entrada
+\family typewriter
+Class-Path
+\family default
+ indica el
+\emph on
+classpath
+\emph default
+ como lista separada por espacios en la que
+\family typewriter
+.
+
+\family default
+ indica el propio fichero y las rutas relativas que no comienzan con
+\family typewriter
+.
+
+\family default
+ lo son respecto al directorio donde se encuentra el comprimido.
+
+\family typewriter
+Main-Class
+\family default
+ indica el nombre completo de la clase principal.
+ Esto permite ejecutar un programa en Java con el comando
+\family typewriter
+java -jar
+\emph on
+fichero.jar
+\family default
+\emph default
+, o abriendo el fichero desde un explorador de ficheros.
+\end_layout
+
+\begin_layout Standard
+Si tenemos una biblioteca en un fichero JAR que queremos usar en nuestro
+ proyecto, creamos dentro una carpeta
+\family typewriter
+lib
+\family default
+, copiamos el comprimido dentro junto con su documentación JavaDoc (descomprimid
+a) y, dentro de Eclipse, pulsamos F5 para actualizar el contenido de
+\family typewriter
+lib
+\family default
+.
+ Pulsamos el fichero de la biblioteca con el botón derecho del ratón, usamos
+
+\begin_inset Quotes fld
+\end_inset
+
+Vía de acceso de construcción
+\begin_inset Formula $\rightarrow$
+\end_inset
+
+Añadir a la vía de construcción
+\begin_inset Quotes frd
+\end_inset
+
+ y aparece una sección
+\begin_inset Quotes fld
+\end_inset
+
+Li
+\begin_inset ERT
+status open
+
+\begin_layout Plain Layout
+
+
+\backslash
+-
+\end_layout
+
+\end_inset
+
+bre
+\begin_inset ERT
+status open
+
+\begin_layout Plain Layout
+
+
+\backslash
+-
+\end_layout
+
+\end_inset
+
+rí
+\begin_inset ERT
+status open
+
+\begin_layout Plain Layout
+
+
+\backslash
+-
+\end_layout
+
+\end_inset
+
+as referidas
+\begin_inset Quotes frd
+\end_inset
+
+ con la biblioteca añadida.
+ Pulsamos aquí con el botón derecho del ratón, en
+\begin_inset Quotes fld
+\end_inset
+
+Propiedades
+\begin_inset Formula $\rightarrow$
+\end_inset
+
+Ubicación del JavaDoc
+\begin_inset Formula $\rightarrow$
+\end_inset
+
+Vía de acceso de ubicación JavaDoc
+\begin_inset Formula $\rightarrow$
+\end_inset
+
+Examinar
+\begin_inset Quotes frd
+\end_inset
+
+ seleccionamos el directorio con la documentación, y pulsamos
+\begin_inset Quotes fld
+\end_inset
+
+Validar
+\begin_inset Quotes frd
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+Para generar un archivo JAR de nuestro proyecto, usamos
+\begin_inset Quotes fld
+\end_inset
+
+Archivo
+\begin_inset Formula $\rightarrow$
+\end_inset
+
+Exportar
+\begin_inset Formula $\rightarrow$
+\end_inset
+
+Java
+\begin_inset Quotes frd
+\end_inset
+
+ y podemos elegir
+\begin_inset Quotes fld
+\end_inset
+
+Archivo JAR
+\begin_inset Quotes frd
+\end_inset
+
+ para empaquetar una biblioteca (sin clase principal),
+\begin_inset Quotes fld
+\end_inset
+
+Archivo JAR ejecutable
+\begin_inset Quotes frd
+\end_inset
+
+ para un ejecutable o
+\begin_inset Quotes fld
+\end_inset
+
+JavaDoc
+\begin_inset Quotes frd
+\end_inset
+
+ para extraer la documentación JavaDoc.
+\end_layout
+
+\begin_layout Standard
+Si elegimos la segunda opción, tenemos las opciones:
+\end_layout
+
+\begin_layout Itemize
+
+\emph on
+Launch configuration
+\emph default
+: Para elegir la clase principal de entre las posibles.
+\end_layout
+
+\begin_layout Itemize
+
+\emph on
+Export destination
+\emph default
+: Dónde queremos que se guarde el fichero JAR.
+\end_layout
+
+\begin_layout Itemize
+
+\emph on
+Library handling
+\emph default
+:
+\begin_inset Quotes fld
+\end_inset
+
+
+\emph on
+Extract required libraries into generated JAR
+\emph default
+
+\begin_inset Quotes frd
+\end_inset
+
+ descomprime los ficheros JAR de las bibliotecas e introduce las clases
+ en el JAR de salida.
+
+\begin_inset Quotes fld
+\end_inset
+
+
+\emph on
+Package required libraries into generated JAR
+\emph default
+
+\begin_inset Quotes frd
+\end_inset
+
+ guarda los propios ficheros JAR de las bibliotecas dentro del nuestro.
+
+\begin_inset Quotes fld
+\end_inset
+
+
+\emph on
+Copy required libraries into a sub-folder next to the generated JAR
+\emph default
+
+\begin_inset Quotes frd
+\end_inset
+
+ crea un directorio junto al fichero JAR donde mete las bibliotecas, que
+ añade como dependencias en el
+\family typewriter
+Class-Path
+\family default
+ del manifiesto.
+\end_layout
+
+\begin_layout Standard
+JavaDoc es una forma de generar documentación de código Java a partir de
+ comentarios.
+ Para ello, encima de cada clase, interfaz, etc., método o incluso paquete,
+ creamos un comentario como el siguiente:
+\end_layout
+
+\begin_layout Standard
+\begin_inset Box Frameless
+position "t"
+hor_pos "c"
+has_inner_box 1
+inner_pos "t"
+use_parbox 0
+use_makebox 0
+width "100col%"
+special "none"
+height "1in"
+height_special "totalheight"
+thickness "0.4pt"
+separation "3pt"
+shadowsize "4pt"
+framecolor "black"
+backgroundcolor "none"
+status open
+
+\begin_layout Plain Layout
+
+\family typewriter
+/**
+\end_layout
+
+\begin_layout Plain Layout
+
+\family typewriter
+\begin_inset space ~
+\end_inset
+
+*
+\emph on
+Descripción.
+\end_layout
+
+\begin_layout Plain Layout
+
+\family typewriter
+\begin_inset space ~
+\end_inset
+
+*
+\end_layout
+
+\begin_layout Plain Layout
+
+\family typewriter
+\begin_inset space ~
+\end_inset
+
+* @param
+\emph on
+nombre
+\emph default
+
+\emph on
+Descripción del parámetro
+\begin_inset Quotes fld
+\end_inset
+
+nombre
+\begin_inset Quotes frd
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Plain Layout
+
+\family typewriter
+\begin_inset space ~
+\end_inset
+
+*
+\family default
+...
+\end_layout
+
+\begin_layout Plain Layout
+
+\family typewriter
+\begin_inset space ~
+\end_inset
+
+* @return
+\emph on
+Valor devuelto.
+\end_layout
+
+\begin_layout Plain Layout
+
+\family typewriter
+\begin_inset space ~
+\end_inset
+
+* @throws
+\emph on
+Tipo Significado si el método lanza una excepción del Tipo dado.
+\end_layout
+
+\begin_layout Plain Layout
+
+\family typewriter
+\begin_inset space ~
+\end_inset
+
+*
+\family default
+...
+\end_layout
+
+\begin_layout Plain Layout
+
+\family typewriter
+\begin_inset space ~
+\end_inset
+
+* @seeAlso
+\emph on
+Clase,método,etc.
+\end_layout
+
+\begin_layout Plain Layout
+
+\family typewriter
+\begin_inset space ~
+\end_inset
+
+*/
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Cualquier parte puede omitirse (de hecho muchas son específicas para métodos),
+ y puede usarse código HTML o marcadores propios de JavaDoc (por ejemplo,
+ para enlazar a otra clase o método).
+ Si un método redefine a otro sin cambiar la semántica, podemos usar
+\family typewriter
+/** {@inheritDoc} */
+\family default
+ para heredar la documentación.
+\end_layout
+
+\end_body
+\end_document