Mejores prácticas trabajando con MongoDB y Java

Version

Major Changes

Doc

Version

Major Changes

Doc

1.0

  • generación del documento para el uso de MongoDB con Java

 

1.1

  • Se agregó la convención general en MongoDB para el nombrado de colecciones y propiedades

 

 

A continuación, se enlistan una serie de buenas prácticas que hay que considerar a la hora de trabajar con MongoDB con Java.

  1. Usar el controlador oficial de MongoDB: El controlador oficial de MongoDB para Java es la forma más recomendada de trabajar con MongoDB en Java. Este controlador está diseñado para trabajar de manera eficiente con MongoDB y proporciona una API intuitiva y fácil de usar.

  2. Usar el patrón Singleton: La conexión a la base de datos debe ser única en la aplicación. Para lograr esto, se recomienda utilizar el patrón Singleton, que asegura que solo haya una instancia de la conexión a la base de datos en la aplicación.
    Ejemplo:

    import org.bson.Document; import com.mongodb.Block; import com.mongodb.MongoClient; import com.mongodb.MongoClientURI; import com.mongodb.client.MongoCollection; import com.mongodb.client.MongoDatabase; // Demo program for connecting to MongoDB. // Uses singleton pattern for MongoClient. public class MongoDemo { private static MongoClient mClient; // Singleton for MongoClient // Creates a single connection pool internally private MongoClient getMongoClient() { if (mClient == null) { mClient = new MongoClient(new MongoClientURI("mongodb://localhost:27017")); } return mClient; } // Utility method to get database instance private MongoDatabase getDB() { return getMongoClient().getDatabase("test"); } // Utility method to get user collection private MongoCollection<Document> getUserCollection() { return getDB().getCollection("user"); } public static void main(String[] args) { MongoDemo demo = new MongoDemo(); demo.insertUser(); demo.queryUsers(); } // Read all documents from user collection private void queryUsers() { getUserCollection().find().forEach(new Block<Document>() { @Override public void apply(Document t) { System.out.println(t); } }); } // Insert a document in user collection private void insertUser() { Document document = new Document("username","qpt") .append("email", "testemail@example.com"); getUserCollection().insertOne(document); } }
  3. Utilizar las operaciones atómicas de MongoDB: MongoDB tiene operaciones atómicas para la actualización de documentos, lo que significa que una actualización será aplicada en su totalidad o no se aplicará en absoluto. Es importante utilizar estas operaciones para evitar problemas de concurrencia.
    Ejemplos:

    @Autowired MongoOperations mongoOperations; . . mongoOperations .updateFirst( new Query(Criteria.where("website_id").is(1)), new Update() .inc("hits", 1) <-- .set("lastAccess",new Date()) <-- .unset("inactive"), <-- WebsiteVisit.class ); .
  4. Unir los documentos en lugar de las colecciones: En lugar de almacenar datos relacionados en colecciones separadas, se recomienda almacenarlos en un solo documento y usar la agregación de MongoDB para unirlos.

  5. Asegurar que las consultas sean eficientes: Utilizar el índice adecuado y evitar hacer consultas complejas. Esto ayudará a mejorar el rendimiento de la base de datos.

  6. Considerar el tamaño máximo del documento: MongoDB tiene un límite de tamaño de documento de 16 MB. Asegurarse de que los documentos no superen este tamaño para evitar problemas de rendimiento.

  7. Usar la validación de esquema: MongoDB tiene una función de validación de esquema que permite definir restricciones de validación para los documentos. Utilizar esta función para asegurarnos de que sus documentos cumplan con las reglas de validación.

  8. Usar la funcionalidad de replica sets: MongoDB tiene una funcionalidad de replica sets que permite la replicación de datos en múltiples servidores. Utilice esta función para mejorar la disponibilidad de sus datos y reducir los tiempos de inactividad.
    Siguiendo estas buenas prácticas, podremos utilizar MongoDB de manera efectiva y mejorar el rendimiento de sus aplicaciones en Java.

Convenciones Generales en MongoDB

Al utilizar MongoDB, hay algunas convenciones generales que se recomienda seguir para facilitar el desarrollo y la mantenibilidad de la base de datos. A continuación, te menciono algunas de estas convenciones:

  1. Nombramiento de colecciones: Es común utilizar nombres en minúsculas y en plural para las colecciones. Por ejemplo, en lugar de "Usuario", se suele utilizar "usuarios" como nombre de la colección.

  2. Nombramiento de campos: Se recomienda utilizar nombres de campos en minúsculas y separados por guiones bajos (_). Por ejemplo, en lugar de "NombreCompleto", es preferible utilizar "nombre_completo".

  3. Identificador único: Cada documento en MongoDB debe tener un identificador único en el campo "_id". Por defecto, MongoDB asigna un identificador único tipo ObjectId si no se especifica uno explícitamente.

  4. Indexación: Es importante crear índices adecuados en los campos utilizados frecuentemente para consultas. Los índices ayudan a mejorar el rendimiento de las consultas al permitir búsquedas más eficientes.

  5. Uso de documentos embebidos: MongoDB permite embeber documentos dentro de otros documentos. Es recomendable utilizar documentos embebidos cuando la información embebida es relevante solo en el contexto del documento padre. Por ejemplo, un documento "usuario" puede contener un documento embebido "dirección".

  6. Evitar joins complejos: A diferencia de las bases de datos relacionales, en MongoDB no se realizan joins complejos entre colecciones. En su lugar, se fomenta la denormalización de los datos para que la información necesaria esté contenida en un solo documento o colección.

  7. Uso de transacciones: MongoDB soporta transacciones desde la versión 4.0 en adelante. Se recomienda utilizar transacciones cuando se requiere mantener la consistencia en operaciones que afectan múltiples documentos.

  8. Versionado de documentos: En ocasiones, es necesario realizar cambios en la estructura de los documentos existentes. Se sugiere utilizar algún mecanismo de versionado para manejar estas situaciones, como agregar un campo "version" en el documento.

https://fintechdigital.atlassian.net/browse/SPMS-51