¡Esta es una revisión vieja del documento!
Capa de controladores
El sistema SIMO implementa Controladores de tipo REST, su función es proporcionar la interfaz entre el cliente, implementado con HTML y Javascript y el servidor,
Naturalmente, la comunicación entre los dos se realiza mediante el protocolo HTTP, y en particular se implementa utilizando el estilo REST, especificamente este estilo se implementa en el SIMO de la siguiente manera:
Cada recurso (Entidad JPA) está asociado a una
URL base: Ej /convocatorias
Las entidades que dependen o tienen relaciones de composicion con otras entidades (por ejemplo etapa y convocatoria), obtienen su
URL a partir de la
URL de la entidad que las contiene. Ej. /convocatorias/{<id_convocatoria>}/etapas
Se utilizan los verbos HTTP para implementar las operaciones CRUD
El verbo POST se utiliza para creación (Create)
El verbo GET se utiliza para lectura (Read)
El verbo PUT se utiliza para actualizacion (Update)
El verbo DELETE se utiliza para eliminación (Delete)
Otras operaciones aparte de las CRUD básicas se implementan con el verbo PUT y un parámetro de ruta (una porción de la ruta
URL asociada a la operación) que le indica al servidor que operación se necesita invocar. Ej /convocatorias/<Operacion no CRUD>
Las operaciones GET que retornan listas de entidades se presentan en dos versiones, con paginación y sin paginación.
Existen operaciones GET específicas para ser utilizadas en controles de tipo
ComboBox o Select, estas operaciones incluyen en su
URL la palabra list. Ej /convocatorias/list