Esta página es de solo lectura. Puedes ver la fuente pero no puedes cambiarla. Pregunta a tu administrador si crees que esto es incorrecto.

<h1>Repositorios SIMO</h1> <div class="level1"> <p> Un repositorio SIMO proporciona los métodos de acceso a la capa de persistencia. En particular, los métodos de los repositorios proveen la lógica para manipular objetos de entidades JPA e interactuar con el sistema de almacenamiento subyacente mediante operaciones de tipo CRUD (Create, Retrieve, Update, Delete). Estas operaciones CRUD proporcionan un nivel de abstracción mayor, en el sentido de que no se requiere el acceso directo a las primitivas del API JPA. </p> <p> Los repositorios SIMO se basan en los repositorios Spring Data JPA, si bien los repositorios Spring Data JPA proporcionan funcionalidad CRUD básica, SIMO ha extendido estas funcionalidades mediente el uso de herencia y tipos genéricos con el objeto de incluir operaciones adicionales, estas operaciones incluyen operaciones de búsqueda avanzada basadas en Hibernate Search y operaciones optimizadas para el despliegue de listas, entre otras. En el siguiente diagrama se muestra la estructura de herencia de un repositorio SIMO que a su vez sirve para ilustrar el camino de evolución desde un repositorio Spring Data JPA hasta un repositorio SIMO. </p> <p> En su versión más sencilla, un repositorio Spring Data JPA es una interfaz que extiende de <a href="/cnscwiki/doku.php?id=simo:documentos:tecnicos:crudrepository" class="wikilink2" title="simo:documentos:tecnicos:crudrepository" rel="nofollow">CrudRepository</a>, al hacerlo, el framework Spring produce una implementación por defecto que incluye los métodos básicos de <a href="https://docs.spring.io/spring-data/commons/docs/current/api/org/springframework/data/repository/CrudRepository.html" class="urlextern" title="https://docs.spring.io/spring-data/commons/docs/current/api/org/springframework/data/repository/CrudRepository.html" rel="nofollow">docs.spring.io/spring-data/commons/docs/current/api/org/springframework/data/repository/CrudRepository.html</a> <a href="/cnscwiki/doku.php?id=simo:documentos:tecnicos:crudrepository" class="wikilink2" title="simo:documentos:tecnicos:crudrepository" rel="nofollow">CrudRepository</a>, y que básicamente son los métodos CRUD tradicionales. Nótese que el repositorio recibe un parámetro de tipo que es la entidad JPA que maneja el repositorio, es decir que los métodos CRUD quedan parametrizados para manejar una entidad en particular. </p> <p> Otra característica muy importante de los repositorios Spring Data JPA, es la capacidad de crear métodos finder o incluso métodos delete, update e insert, sin necesidad de escribir su implementación. Símplemente al escribir la declaración del método, el framework es capaz de construir la lógica a partir del nombre del método bajo unas convenviones establecidas, o a través de sentencias JPQL especificadas mediante la anotación @Query. </p> <p> La siguiente interfaz en el sistema de herencia es <a href="/cnscwiki/doku.php?id=simo:documentos:tecnicos:pagingandsortingrepository" class="wikilink2" title="simo:documentos:tecnicos:pagingandsortingrepository" rel="nofollow">PagingAndSortingRepository</a> (<a href="https://docs.spring.io/spring-data/commons/docs/current/api/org/springframework/data/repository/PagingAndSortingRepository.html" class="urlextern" title="https://docs.spring.io/spring-data/commons/docs/current/api/org/springframework/data/repository/PagingAndSortingRepository.html" rel="nofollow">docs.spring.io/spring-data/commons/docs/current/api/org/springframework/data/repository/PagingAndSortingRepository.html</a>), esta interfaz actua de forma similar a <a href="/cnscwiki/doku.php?id=simo:documentos:tecnicos:crudrepository" class="wikilink2" title="simo:documentos:tecnicos:crudrepository" rel="nofollow">CrudRepository</a> pero proporciona versiones de los métodos CRUD capaces de manejar paginación y ordenamiento. Al igual que en el caso de <a href="/cnscwiki/doku.php?id=simo:documentos:tecnicos:crudrepository" class="wikilink2" title="simo:documentos:tecnicos:crudrepository" rel="nofollow">CrudRepository</a>, un repositorio Spring Data JPA solo necesita extender la interfaz para que el framework provea toda la interfaz. </p> <p> Las siguientes clases e interfaces en el sistema de herencia ya no hace parte de el framework Spring, y por tanto, es en este punto donde un repositorio SIMO se empieza a diferenciar de un repositorio Spring Data JPA. </p> <p> La primera de ellas es <a href="/cnscwiki/doku.php?id=simo:documentos:tecnicos:searchablerepository" class="wikilink2" title="simo:documentos:tecnicos:searchablerepository" rel="nofollow">SearchableRepository</a>, esta interfaz define métodos orientados a proporcionar al repositorio capacidades de búsqueda. Se definen tres métodos pricipales, con sus respectivas versiones paginadas </p> <ul> <li class="level1"> <b>findByQuery: </b> Encuentra entidades utilizando JPA (Criteria)</li> <li class="level2"> <b>search: </b> Encuentra entidades utilizando Hibernate Search y Lucene</li> <li class="level2"> <b>find: </b> Encuentra entidades con base en la propiedad search_mode del sistema (0 utiliza search, 1 utiliza preferiblemente search y si hay un error utiliza findByQuery, 2 utiliza findByQuery</li> </ul> <p> La segunda interfaz es <a href="/cnscwiki/doku.php?id=simo:documentos:tecnicos:listablerepository" class="wikilink2" title="simo:documentos:tecnicos:listablerepository" rel="nofollow">ListableRepository</a> y define métodos para listar conjuntos de entidades (para ser usados en controles de tipo <a href="/cnscwiki/doku.php?id=simo:documentos:tecnicos:combobox" class="wikilink2" title="simo:documentos:tecnicos:combobox" rel="nofollow">ComboBox</a> o List o Select), estos métodos se diferencian de los de búsqueda principalmente en que están orientados a buscar por un solo campo en la entidad (generalmente es el campo nombre) con el fin de soportar funciones de autocompletar. Esta interfaz define los siguientes dos métodos: </p> <ul> <li class="level1"> <b>listByQuery: </b> Lista entidades usando JPA</li> <li class="level2"> <b>list: </b> Lista entidades usando Hibernate Search y Lucene o JPA según el parámetro search_mode</li> </ul> </div>