CitarCualquier sugerencia, por favor, háganmelo saber por MP

CitarEn caso tengan problemas con los ejercicios planteados, abrir un tema de la manera normal

• JDK
  
  
  
  • You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
• Netbeans
  
  
  
  • You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
• JavaFX Scene Builder
  
  
  
  • You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
• PostgreSQL
  
  
  
  • You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
    
• GlassFish
  
  
  
  • You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login

• Habilidades de desarrolladores calificados (Lenguaje primario) a nivel mundial
• Cursos por lenguaj
• Frameworks/librerías

• Proporcionar catálogos de elementos reusables en el diseño de sistemas software.
  
• Evitar la reiteración en la búsqueda de soluciones a problemas ya conocidos y solucionados anteriormente.
  
• Formalizar un vocabulario común entre diseñadores.
  
• Estandarizar el modo en que se realiza el diseño.
  
• Facilitar el aprendizaje de las nuevas generaciones de diseñadores condensando conocimiento ya existente.
  
  Asimismo, no pretenden:
  
  
• Imponer ciertas alternativas de diseño frente a otras.
  
• Eliminar la creatividad inherente al proceso de diseño.
  
  No es obligatorio utilizar los patrones, solo es aconsejable en el caso de tener el mismo problema o similar que soluciona el patrón, siempre teniendo en cuenta que en un caso particular puede no ser aplicable. "Abusar o forzar el uso de los patrones puede ser un error".
  
  

  ---

  PATRÓN ADAPTER

  ---

  
  
  El patrón adapter nos permite ampliar la funcionalidad de una clase o interfaz adaptando objetos que no coinciden con una determinada jerarquía de clases.
  
  Convierte la interfaz de una clase en otra interfaz que el cliente espera. Adapter permite a las clases trabajar juntas, lo que de otra manera no podría hacerlo debido a sus interfaces incompatibles.
  
  Cuándo usarlo:
  
  
• Se desea usar una clase existente, y su interfaz no se iguala con la necesitada.
  
• Cuando se desea crear una clase reusable que coopera con clases no relacionadas, es decir, las clases no tienen necesariamente interfaces compatibles.
  
  
  Problema: Se nos pide adaptar un auto eléctrico a un sistema de abastecimiento de combustible para autos. Siendo que el auto eléctrico, utiliza como combustible la energía eléctrica.
  
  Solución: Utilizar el patrón Adapter para extender la funcionalidad de la interfaz adaptando el auto eléctrico.
  
  Creamos una interfaz llamada Car que representará de forma genérica a un Auto:
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.adapter;
  
  public interface Car {
  
  	void fillTank();
  	default void start() {
  		System.out.println("Encendiendo auto...");
  	}
  }

  
  
  NOTA: el método start() lo predefinimos porque será el mismo para todos las implementaciones.
  
  Ahora sus implementaciones: GasolineCar y GasCar. Representan un auto a gasolina y otro a gas.
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.adapter;
  
  public class GasolineCar implements Car {
  
  	public GasolineCar() {
  		super(); // llamada al constructor padre
  		System.out.println("Creando un auto a gasolina...");
  	}
  	
  	@Override
  	public void fillTank() {
  		System.out.println("Colocando gasolina...");
  	}
  }
  

  
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.adapter;
  
  public class GasCar implements Car {
  
  	public GasCar() {
  		super(); // llamada al constructor padre
  		System.out.println("Creando un auto a gas...");
  	}
  	
  	@Override
  	public void fillTank() {
  		System.out.println("Colocando gas...");
  	}
  
  }

  
  
  Ambos autos, GasolineCar y GasCar necesitan combustible para funcionar. Por eso, el método fillTank llena el combustible de ellos, dependiendo si es gasolina o gas.
  
  Ahora queremos añadir un auto eléctrico a nuestra jerarquía de clases.
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.adapter;
  
  public class ElectricCar {
  
  	public ElectricCar() {
  		super(); // llamada al constructor padre
  		System.out.println("Creando un auto eléctrico...");
  	}
  	
  	public void connect() {
  		System.out.println("Conectando motor a generador de electricidad...");
  	}
  }

  
  
  Nos damos con la sorpresa que éste auto no coincide con nuestra jerarquía. La interfaz Car dice que todos los autos que la implementen deben tener el método fillTank. Pero, ¿Como un auto eléctrico puede llenar el tanque? ¿Cómo hacemos para adaptar éste auto a nuestra jerarquía?
  
  Un error es común es modificar la interfaz o clase abstracta. Ésto viola el principio OCP, el cual nos dice:
  

  Citar
  Las entidades de software deben ser abiertas para ser extendidas y cerradas para no ser modificadas.

  
  Aquí toma importancia en patrón Adapter. Éste patrón nos permite ampliar la funcionalidad de una interfaz si tener que cambiar código en ella. Veamos como funciona.
  
  

  package org.underc0de.adapter;
  
  public class ElectricCarAdapter implements Car {
  
  	ElectricCar electricCar;
  	
  	public ElectricCarAdapter() {
  		electricCar = new ElectricCar();
  	}
  	
  	@Override
  	public void fillTank() {
  		electricCar.connect();
  		
  	}
  
  }

  
  
  Como vemos hemos podido adaptar nuestro auto eléctrico a nuestra interfaz Car. ¡Ahora, podemos crear tanto autos a gasolina, gas o eléctricos aplicando polimorfismo!
  
  Veamos que salida nos arroja:
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.adapter;
  
  public class AdapterTest {
  
  	public static void main(String[] args) {
  		Car gasolineCar = new GasolineCar();
  		gasolineCar.fillTank();
  		gasolineCar.start();
  		
  		System.out.println();
  		
  		Car gasCar = new GasCar();
  		gasCar.fillTank();
  		gasCar.start();
  		
  		System.out.println();
  		
  		Car electricCar = new ElectricCarAdapter();
  		electricCar.fillTank();
  		electricCar.start();
  	}
  
  }

  
  
  Salida:
  
  

  Creando un auto a gasolina...
  Colocando gasolina...
  Encendiendo auto...
  
  Creando un auto a gas...
  Colocando gas...
  Encendiendo auto...
  
  Creando un auto eléctrico...
  Conectando motor a generador de electricidad...
  Encendiendo auto...

  
  
  Y así podemos extender la funcionalidad de nuestra aplicación de forma sencilla y eficiente.
  
  

  ---

  PATRÓN FACADE

  ---

  
  
  Descripción: El patrón fachada viene motivado por la necesidad de estructurar un entorno de programación y reducir su complejidad con la división en subsistemas, minimizando las comunicaciones y dependencias entre éstos.
  
  Cuándo usarlo:
  
  
• Se usa para proporcionar una interfaz sencilla para un sistema complejo.
  
• Se quiere desacoplar un subsistema de sus clientes u otros subsistemas, haciéndolo mas independiente y portable.
  
• Se quiera dividir los sistemas en niveles: las fachadas serian el punto de entrada a cada nivel.
  
  Pros/contras:
  
  
• + La principal ventaja del patrón fachada consiste en que para modificar las clases de los subsistemas, sólo hay que realizar cambios en la interfaz/fachada, y los clientes pueden permanecer ajenos a ello. Además, y como se mencionó anteriormente, los clientes no necesitan conocer las clases que hay tras dicha interfaz.
  
• - Como inconveniente, si se considera el caso de que varios clientes necesiten acceder a subconjuntos diferentes de la funcionalidad que provee el sistema, podrían acabar usando sólo una pequeña parte de la fachada, por lo que sería conveniente utilizar varias fachadas más específicas en lugar de una única global.
  
  Problema: Crear una aplicación que haga tres operaciones bancarias: Crear una cuenta, depositar dinero y retirar dinero. Las operaciones deben hacerse dentro de una sola entidad que las maneje.
  
  Solución: Aplicar el patrón Facade para encapsular todos los objetos que hacen las 3 operaciones.
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.facade;
  
  public class Bank {
  
  	public Bank() {
  		
  	}
  	
  	public void createAccount(String account) {
  		System.out.println("Creando cuenta N° "+account);
  	}
  }

  
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.facade;
  
  public class Deposit {
  
  	public Deposit() {
  		
  	}
  	
  	public void makeDeposit(double amount, String account) {
  		System.out.println("Se ha depositado $"+amount+" a la cuenta "+account);
  	}
  	
  }

  
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.facade;
  
  public class Withdrawal {
  
  	public Withdrawal() {
  		
  	}
  	
  	public void makeWidthdrawal(double amount, String account) {
  		System.out.println("Se ha retirado $"+amount+" de la cuenta "+account);
  	}
  	
  }

  
  
  Ahora, creamos nuestra clase principal:
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.facade;
  
  public class Facade {
  
  public static void main(String[] args) {
  
  	Bank bank = new Bank();
  	Deposit deposit = new Deposit();
  	Withdrawal withdrawal = new Withdrawal();
  		
  	bank.createAccount("9343435093");
  	deposit.makeDeposit(2599.90, "9343435093");
  	withdrawal.makeWidthdrawal(699.90, "9343435093");
  			
  	}
  
  }

  
  
  Como vemos creamos 3 objetos los cuales se encargan de efectuar las acciones. Pero, ¿es necesario crear éstos tres objetos en éste ambito? ¿Los vamos a necesitar siempre?
  
  Una mejor idea sería encapsular éstos objetos dentro de uno solo que se encargue de realizar todas las operaciones. Éste es el propósito del patrón Facade, actuar como intermediario entre la interfaz y las funcionalidades de un sistema. Veamos como se representa:
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.facade;
  
  public class OperationsFacade {
  
  	
  	public OperationsFacade() {
  	}
  	
  	public void createAccount(String account) {
  		new Bank().createAccount(account);
  	}
  	
  	public void makeDeposit(double amount, String account) {
  		new Deposit().makeDeposit(amount, account);
  	}
  	
  	public void makeWithdrawal(double amount, String account) {
  		new Withdrawal().makeWidthdrawal(amount, account);
  	}
  	
  }

  
  
  Como podemos observar, ésta clase encapsula el comportamiento de las clases Bank, Deposit y Withdrawal. Ya no tenemos que declarar los objetos porque éstos se crean en los métodos de OperationsFacade y se destruyen al finalizar el mismo. ¡Además ahorramos memoria!
  
  Ahora, veamos como queda la clase principal:
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.facade;
  
  public class FacadeTest {
  
  	public static void main(String[] args) {
  		OperationsFacade facade = new OperationsFacade();
  		facade.createAccount("9343435093");
  		facade.makeDeposit(2599.90, "9343435093");
  		facade.makeWithdrawal(699.90, "9343435093");
  	}
  
  }

  
  
  Como podemos ver, solo necesitamos de un objeto OperationsFacade para realizar todas las operaciones. Así aplicamos también el principio KISS (Keep it simple stupid!).
  
  Salida:
  
  

  Creando cuenta N° 9343435093
  Se ha depositado $2599.9 a la cuenta 9343435093
  Se ha retirado $699.9 de la cuenta 9343435093

  
  
  

  ---

  PATRÓN ABSTRACT FACTORY

  ---

  
  
  Descripción: El patrón Abstract Factory nos permite crear, mediante una interfaz, conjuntos o familias de objetos (denominados productos) que dependen mutuamuente y todo esto sin especificar cual es el objeto concreto.
  
  Cuándo usarlo:
  
  
• Un sistema debe ser independiente de como sus objetos son creados.
  
• Un sistema debe ser 'configurado' con una cierta familia de productos.
  
• Se necesita reforzar la noción de dependencia mutua entre ciertos objetos.
  
  
  Pros/contras:
  
  
• + Brinda flexibilidad al aislar a las clases concretas.
  
• + Facilita cambiar las familias de productos.
  
• - Para agregar nuevos productos se deben modificar tanto las fabricas abstractas como las concretas.
  
  Problema: Se nos pide crear animales de X tipo sin especificar cuál es el objeto en concreto.
  
  Solución: Utilizar el patrón Abstract Factory para crear los objetos solicitados.
  
  Primero, creamos una clase abstracta llamada Animal que representará de forma genérica a un Animal:
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.factory;
  
  public abstract class Animal {
  
  	protected String type;
  	protected String family;
  	protected String habitat;
  	
  	public Animal(String type, String family, String habitat) {
  		this.type = type;
  		this.family = family;
  		this.habitat = habitat;
  	}
  	
  	public String getType() {
  		return type;
  	}
  	
  	public void setType(String type) {
  		this.type = type;
  	}
  
  	public String getFamily() {
  		return family;
  	}
  
  	public void setFamily(String family) {
  		this.family = family;
  	}
  
  	public String getHabitat() {
  		return habitat;
  	}
  
  	public void setHabitat(String habitat) {
  		this.habitat = habitat;
  	}
  
  	@Override
  	public String toString() {
  		return "Tipo de animal: "+getType()+"\nFamilia: "+getFamily()+
  				"\nHábitat: "+getHabitat();
  	}
  }
  

  
  
  Y tres animales que extienden de Animal:
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.factory;
  
  public class Dog extends Animal {
  
  	public Dog(String type, String family, String habitat) {
  		super(type, family, habitat);
  	}
  
  }

  
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.factory;
  
  public class Shark extends Animal {
  
  	public Shark(String type, String family, String habitat) {
  		super(type, family, habitat);
  	}
  
  
  }

  
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.factory;
  
  public class Lion extends Animal {
  
  	public Lion(String type, String family, String habitat) {
  		super(type, family, habitat);
  	}
  
  
  }

  
  
  Bien, ya tenemos nuestros 3 tipos de animales que heredan de Animal: Dog, Shark y Lion. Como la tarea es construir objetos sin especificar de qué tipo son, creamos una fábrica abstracta que especifica la creación de un Animal genérico sin especificar de qué tipo:
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.factory;
  
  public interface AbstractAnimalFactory {
  
  	Animal createAnimal();
  }

  
  
  Ahora, el siguiente paso es hacer las implementaciones de ésta fábrica abstracta, es decir las fábricas concretas que crearán los objetos concretos:
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.factory;
  
  public class DogFactory implements AbstractAnimalFactory {
  
  	protected String type;
  	protected String family;
  	protected String habitat;
  	
  	public DogFactory(String type, String family, String habitat) {
  		this.type = type;
  		this.family = family;
  		this.habitat = habitat;
  	}
  	
  	@Override
  	public Animal createAnimal() {
  		return new Dog(type, family, habitat);
  	}
  
  }

  
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.factory;
  
  public class SharkFactory implements AbstractAnimalFactory {
  
  	protected String type;
  	protected String family;
  	protected String habitat;
  	
  	public SharkFactory(String type, String family, String habitat) {
  		this.type = type;
  		this.family = family;
  		this.habitat = habitat;
  	}
  	
  	@Override
  	public Animal createAnimal() {
  		return new Shark(type, family, habitat);
  	}
  
  }

  
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.factory;
  
  public class LionFactory implements AbstractAnimalFactory {
  
  	protected String type;
  	protected String family;
  	protected String habitat;
  	
  	public LionFactory(String type, String family, String habitat) {
  		this.type = type;
  		this.family = family;
  		this.habitat = habitat;
  	}
  	
  	@Override
  	public Animal createAnimal() {
  		return new Lion(type, family, habitat);
  	}
  
  }

  
  
  Analicemos un poco el código. Cada una de las implementaciones de AbstractAnimalFactory especifican la implementación que tendrá para crear un tipo de animal.
  
  Cada factoría concreta, tiene las 3 propiedades que necesita cada objeto para poder crearse. Así mismo, dichos datos se pasan como parámetros a su constructor para establecer los valores en las propiedades que se utilizarán para crear una instancia del objeto.
  
  Establece las propiedades:
  
  

  public LionFactory(String type, String family, String habitat)

  
  
  Y usa esas mismas propiedades para crear el objeto:
  
  

  @Override
  public Animal createAnimal() {
  	return new Lion(type, family, habitat);
  }

  
  
  Finlamente, se sobre-escribe el método de la factoría abstracta createAnimal() para retornar un nuevo objeto de acuerdo al tipo de factoría. Así, la factoría de Perros, creará objetos tipo Perro, la factoría de Tiburones creará objetos tipo Tiburón y la factoría de Leones, crearán objetos tipo León.
  
  Por último, especificamos una Fábrica global que utilizará las 3 fábricas para crear los objetos (Aquí se aplica también el patrón Facade):
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.factory;
  
  public abstract class AnimalFactory {
  
  	public static Animal create(AbstractAnimalFactory factory) {
  		return factory.createAnimal();
  	}
  }

  
  
  Ésta clase recibe un objeto que implemente la interfaz AbstractAnimalFactory, por lo tanto podrá recibir objetos tipo: DogFactory, SharkFactory y LionFactory. Luego simplemente usa la factoría especificada para crear un animal mediante polimorfismo.
  
  Ahora construyamos nuestra clase principal para probar el funcionamiento del patrón:
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.factory;
  
  public class FactoryTest {
  
  	public static void main(String[] args) {
  		Animal dog = AnimalFactory.create(new DogFactory("Perro","Caninos","Doméstico"));
  		Animal shark = AnimalFactory.create(new SharkFactory("Tiburón", "Lámnidos", "Mar"));
  		Animal lion = AnimalFactory.create(new LionFactory("León", "Felinos", "Selva"));
  		
  		System.out.println(dog.toString());
  		System.out.println();
  		System.out.println(shark.toString());
  		System.out.println();
  		System.out.println(lion.toString());
  	}
  }

  
  
  Utilizamos el método estático create() de AnimalFactory que recibe una implementación de la interfaz AbstractAnimalFactory, en éste caso un objeto DogFactory al que se le asignan los valores "Perro", "Caninos" y "Doméstico" y finalmente AnimalFactory llama al método createAnimal() de DogFactory para crear un animal tipo Dog y devolverlo hacia AnimalFactory que lo devuelve y lo guarda en el objeto 'dog'. El mismo procedimiento es para todas las factorías.
  
  Salida:
  
  

  Tipo de animal: Perro
  Familia: Caninos
  Hábitat: Doméstico
  
  Tipo de animal: Tiburón
  Familia: Lámnidos
  Hábitat: Mar
  
  Tipo de animal: León
  Familia: Felinos
  Hábitat: Selva

  
  
  Y de ésta manera sencilla, podemos usar tantas fábricas como queramos para poder crear objetos si generar dependencias
  
  

  ---

  PATRÓN SINGLETON

  ---

  
  
  Cuándo usarlo:
  
  
• Cuando la aplicación requiere que solo exista una instancia de un determinado objeto.
  
  Problema: Encapsular la configuración de una aplicación en un objeto y compartirlo con los demás objetos de la aplicación que lo requiera.
  
  Solución: Utilizar el patrón Singleton para encapsular la configuración de la aplicación.
  
  Para utilizar éste patrón se deben seguir dos reglas:
  
  
• El primer paso es hacer el constructor privado para que no se pueda llamar y por lo tanto, no se puedan crear instancias.
  
• El segundo paso es crear una instancia de la clase y devolverla mediante un método estático.
  
  Teniendo en cuenta éstas reglas, creamos una clase que representa a la configuración de la aplicación:
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.singleton;
  
  import java.util.HashMap;
  import java.util.Map;
  
  public class Configuration {
  
  	private Map<String,Object> appOptions = null;
  	private static Configuration config;
  	
  	private Configuration() {
  		
  	}
  	
  	public static Configuration getConfiguration() {
  		if(config == null) {
  			config = new Configuration();
  		}
  		return config;
  	}
  
  	public Map<String,Object> getAppOptions() {
  		if(appOptions == null) {
  			appOptions = new HashMap<>();
  			appOptions.put("theme", "dark");
  			appOptions.put("show_hidde_files", true);
  		}
  		return appOptions;
  	}
  
  	public void setAppOptions(Map<String,Object> appOptions) {
  		this.appOptions = appOptions;
  	}
  	
  }

  
  
  Y simplemente, cuando la necesitemos, obtenemos su única instancia:
  
  You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  

  package org.underc0de.singleton;
  
  import java.util.Map;
  
  public class SingletonTest {
  
  	public static void main(String[] args) {
  		Configuration cfg = Configuration.getConfiguration();
  		
                  // recorre el hashmap para leer las claves y valores
  		for(Map.Entry<String, Object> entry: cfg.getAppOptions().entrySet()) {
  			System.out.println(entry.getKey()+": "+entry.getValue());
  		}
  
  	}
  
  }

  
  
  Salida:
  
  

  show_hidde_files: true
  theme: dark

  
  
  
  NOTA IMPORTANTE:
  
  Generalmente, cuando se usa éste patrón, se garantiza que solamente existirá una instancia de dicha clase. Pero, si se trata de una aplicación web y se va a integrar una aplicación web con otra, es probable que ya no exista una sola instancia.
  
  Ésto se debe a los ClassLoaders. Cada contenedor de cada aplicación web (WAR) tiene su propio ClassLoader, por lo que en el supuesto caso de una integración de WARs, las instancias serán dos y no una como se había previsto.
  
  Una mejor forma de de implementar el patrón Singleton es mediante un enum, como recomienda Joshua Bloch. Al ser un enum, todas sus propiedades serán constantes únicas, no se pueden crear nuevas, solo utilizar las ya descritas.
  
  

  public enum Configuration {
  	INSTANCE;
  	
  	private Map<String, Object> options;
  	
  	public Map<String, Object> getOptions() {
  		if(options == null)
  			fillOptions();
  		return options;
  	}
  	
  	private void fillOptions() {
  		options = new HashMap<>();
  		options.put("theme", "Dark");
  		options.put("show_hidden_files", true);
  	}
  	
  }

  
  
  
  En el capítulo II, veremos más patrones de diseño. Nos vemos.
  
  

  ---

  
  
  By Gus.

public class Song implements Serializable {
	private Integer id;
	private String name;
	private Long duration;

	public Song() {

	}
	public Song(Integer id, String name, Long duration) {
		this.id = id;
		this.name = name;
		this.duration = duration;
	}
	// getters y setters
}

• Variables privadas
  
• Un constructor vacío
  
• Getters y setters
  
• No implementar nada del exterior
  
  Un POJO no debe implementar ni heredar nada. Por otro lado, un JavaBean, tiene como requisito implementar la interface Serializable. La interface Serializable hace que el objeto sea descompuesto/recompuesto en una secuencia de Bytes, permitiendo así que éste objeto pueda ser transportado en diferentes ámbitos como pueden ser: ficheros, sockets, peticiones HTTP, etc.
  
  Un JavaBean debe de implementar Serializable porque éste va a ser transportado o persistido, por lo que, si no implementara la interface Serializable, no podría ser posible su transporte.
  
  Ahora, hagamos una clase que sirva como servicio o comúnmente llamado DAO:
  
  

  
  public class SongService {
  	private static final Map<Integer, Song> songs;
  	static {
  		songs = new HashMap<>();
  		songs.put(1, new Song(1, "Enter Sandman", 3500L));
  		songs.put(2, new Song(2, "The day that never comes", 5000L));
  		songs.put(3, new Song(3, "Whiskey in the jar", 4000L));
  	}
  	public static Song find(Integer id) {
  		return songs.get(id);
  	}
  	// otros metodos que simulan el crud (create, findAll, update, remove)
  }

  
  
  Ésta clase simula un servicio o DAO. Dispone de un método find, que recibe un entero que representa a un ID. Éste ID es buscado es el Map y es retornado hacia el contexto en que se llamó.
  
  Ahora, resta crear nuestro REST:
  
  

  
  @Path("/music")
  @Stateless
  public class MusicServiceREST {
  	@Path("/find/{id}")
  	@Produces(MediaType.APPLICATION_JSON)
  	public Song findMetallica(@PathParam("id") Integer id) {
  		return SongService.find(id);
  	}
  	// otros servicios (findAll, update, remove, etc)
  }

  
  
  Aquí es necesario explicar algunas cosillas:
  
  
  
  
  • @Path indica una ruta y ésta ruta será mapeada; es decir, todas las peticiones que se hagan a dicha ruta las interceptará el REST.
  
  
  • @Stateless indica que dicha clase es un EJB (Enterprise Java Bean). Un Enterprise Java Bean es una especificación de Java EE, el cual trae una serie de novedades como: JMS, control de concurrencia, transacciones (flujos), servicios de nombre y directorios. Éste concepto lo dejaremos para después. Al estar la clase anotada con @Stateless estamos diciendo que esa clase es un EJB y que soporta las características antes mencionadas. Por ejemplo, al soportar transacciones, aquí se puede inyectar un EntityManager y que el EJB sea el encargado de manejar las transacciones (cuando se abren y cierran). En éste caso, al no haber entidades no es necesario.
  
  
  • @Produces indica qué MIME retornará la petición a dicha ruta (@Path). Aquí podemos especificar que se devolverá el MIME que se crea necesario: text/plain, text/html, application/json, application/xml, etc. En nuestro caso hemos dicho que se devolverá un objeto JSON, que es la representación de nuestro objeto Song.
  
  
  • @PathParam indica el parámetro que se va a formatear en el tipo de dato deseado. En nuestro caso, el parámetro enviado lo especificamos entre llaves, y se llamará id ({id}), así que, formateamos éste parámetro a entero para poder buscar al objeto Song con dicho ID.
  
  Es necesario registrar nuestro REST. Para ello, solo basta hacer:
  
  

  
  @ApplicationPath("api")
  public class RestApplication extends Application {
      @Override
      public Set<Class<?>> getClasses() {
      	Set<Class<?>> rests = new HashSet<>();
      	rests.add(MusicServiceREST.class);
      	return rests;
      }
  }

  
  
  Solo debemos de agregar el class de los REST que tengamos creados para registrarlos. Una vez hecho lo anterior, ya tenemos todo hecho. Ahora, para probarlo, solo tipea la url:
  
  

  http://localhost:8080/tu_proyecto/api/music/find/3

  
  
  La URL anterior, buscará la canción con el ID 3 y lo retornará como JSON:
  
  

  {
      "id": 3,
      "name": "Whiskey in the jar",
      "duration": 4000L
  }

  
  
  En caso se quiera consumir algo, por ejemplo, un XML, debemos de utilizar la anotación @Consumes:
  
  

  @Path("/upload")
  @Consumes(MediaType.APPLICATION_XML)
  @Produces(MediaType.TEXT_HTML)
  public String upload(final InputStream IS) {
      /* proceso */
  }

  
  
  El caso anterior es sin utilizar JAXB. Si utilizáramos JAXB no necesitaríamos el InputStream. Como la petición puede venir desde todo tipo de clientes, es necesario capturarla con un InputStream para poder procesarla.
  
  Ésta es la forma básica en que se crea un servicio REST en Java. Generalmente, se usa un REST como capa intermedia entre el acceso a datos y el cliente.
  

  ---

  
  
  Librerías necesarias:
  
  
• jersey-server
  
• jersey-json

• Diversidad de colores.
  
• Grosor del pincel entre 1 y 30.
  
• Borrador.
  
• Limpiador de lienzo (full clean).
  
• Responsivo.
  
  
  
  
  
  
  
  
  
  
  

  ---

  C{0}digo fuente

  ---

  
  
  El source lo pueden encontrar en mi github: You are not allowed to view links. You are not allowed to view links. Register or Login or You are not allowed to view links. Register or Login
  
  Espero que le sirva a alguien. Nos vemos.
  
  

  ---

  
  
  By Gus.