GMongo 项目技术文档

1. 安装指南

1.1 使用 Maven 安装

GMongo 项目可以通过 Maven 进行安装。在项目的 pom.xml 文件中添加以下依赖：

<dependency>
    <groupId>com.gmongo</groupId>
    <artifactId>gmongo</artifactId>
    <version>1.3</version>
</dependency>

1.2 使用 Gradle 安装

如果你使用的是 Gradle，可以在 build.gradle 文件中添加以下依赖：

dependencies {
    implementation 'com.gmongo:gmongo:1.3'
}

1.3 手动下载

你也可以手动下载 GMongo 的 JAR 文件，并将其添加到项目的 classpath 中。JAR 文件可以从 Maven 中央仓库下载：

http://repo1.maven.org/maven2/com/gmongo/gmongo/

2. 项目的使用说明

2.1 连接 MongoDB

GMongo 提供了两种方式来连接 MongoDB：GMongo 和 GMongoClient。

使用 GMongo

@Grab(group='com.gmongo', module='gmongo', version='1.3')
import com.gmongo.GMongo

def mongo = new GMongo()
def db = mongo.getDB("gmongo")

使用 GMongoClient

@Grab(group='com.gmongo', module='gmongo', version='1.3')
import com.gmongo.GMongoClient
import com.mongodb.MongoCredential
import com.mongodb.ServerAddress

credentials = MongoCredential.createMongoCRCredential('username', 'database', 'password' as char[])
client = new GMongoClient(new ServerAddress(), [credentials])

2.2 插入数据

你可以使用以下几种方式插入数据：

db.languages.insert([name: 'Groovy'])
db.languages.insert(name: 'Ruby')
db.languages << [name: 'Python']

2.3 查询数据

查询数据可以使用 findOne 或 find 方法：

def lang = db.languages.findOne()
assert lang.name == 'Groovy'

2.4 更新数据

更新数据可以使用 $set 操作符：

db.languages.update([name: 'Python'], [$set: [paradigms: ['object-oriented', 'functional', 'imperative']]])

2.5 删除数据

删除数据可以使用 remove 方法：

db.languages.remove(type: 'prototyped')

3. 项目API使用文档

3.1 GMongo 类

GMongo 类是 GMongo 项目的主要入口，提供了与 MongoDB 交互的 API。

方法

• getDB(String dbName): 获取指定数据库的引用。
• getMongo(): 获取底层的 Mongo 实例。

3.2 GMongoClient 类

GMongoClient 类是 GMongo 的扩展，提供了与 MongoDB 3.x 兼容的客户端。

构造函数

• GMongoClient(ServerAddress address, List<MongoCredential> credentials): 使用认证信息连接 MongoDB。

3.3 DBCollection 类

DBCollection 类代表 MongoDB 中的集合，提供了对集合的操作方法。

方法

• insert(Map document): 插入单个文档。
• find(): 查询集合中的所有文档。
• findOne(): 查询集合中的第一个文档。
• update(Map query, Map update): 更新文档。
• remove(Map query): 删除文档。

4. 项目安装方式

4.1 使用 @Grab 注解

如果你使用的是 Groovy 脚本，可以通过 @Grab 注解直接下载 GMongo：

@Grab(group='com.gmongo', module='gmongo', version='1.3')
import com.gmongo.GMongo

def mongo = new GMongo()

4.2 手动下载 JAR 文件

你可以从 Maven 中央仓库手动下载 GMongo 的 JAR 文件，并将其添加到项目的 classpath 中。

4.3 使用构建工具

如果你使用的是 Maven 或 Gradle，可以通过添加依赖来安装 GMongo。

Maven

<dependency>
    <groupId>com.gmongo</groupId>
    <artifactId>gmongo</artifactId>
    <version>1.3</version>
</dependency>

Gradle

dependencies {
    implementation 'com.gmongo:gmongo:1.3'
}

通过以上步骤，你可以轻松地安装和使用 GMongo 项目，与 MongoDB 进行交互。