MongoDB快速入门笔记

网页右边，向下滑有目录索引，可以根据标题跳转到你想看的内容
如果右边没有就找找左边

mongoDB

一、mongoDB安装

1. 下载

1. 进入官网下载https://www.mongodb.com/try/download
2. 下载社区版
   

2、安装

1. 打开下载好的安装包，选择自定义安装
   

3. 配置

1. 在安装目录下，创建文件：data文件夹（数据库文件夹）、logs文件夹（日志文件夹）、并在logs文件夹中创建mongo.log文件（日志文件）、mongo.conf(配置文件)
   
2. 编写mongo.conf文件
   

#数据库路径 
dbpath=D:\biancheng\ruanjian\MongoDB\Server\3.4\data
#日志输出文件路径 
logpath=D:\biancheng\ruanjian\MongoDB\Server\3.4\logs\mongo.log 
#错误日志采用追加模式 
logappend=true 
#启用日志文件，默认启用 
journal=true 
#这个选项可以过滤掉一些无用的日志信息，若需要调试使用请设置为false 
quiet=true 
#端口号 默认为27017 
port=27017

4. 安装和启动MongoDB服务

1. cmd管理员身份进入bin目录，执行如下命令，使用–install选项来安装服务，使用–config选项来指定之前创建的配置文件
   

mongod.exe --config "D:\biancheng\ruanjian\MongoDB\Server\3.4\mongo.conf" --install --serviceName "MongoDB"

2. 启动服务
   

net start MongoDB

3. 测试是否启动成功
   
4. 其它命令介绍
   

二、客户端工具studio3t安装

studio3t

1. mongodb优秀的客户端工具，官网：https://studio3t.com/

下载安装

创建连接

三、快速入门

1. 基础概念

1. 在mongodb中是通过数据库、集合、文档的方式来管理数据，下边是mongodb与关系数据库的一些概念对比

SQL术语/概念	MongoDB术语/概念	解释/说明
database	database	数据库
table	collection	数据库表/集合
row	document	数据记录行/文档
column	field	数据字段/域
index	index	索引
table joins		表连接（MongoDB不支持）
primary key	primary key	主键，MongoDB自动在每个集合中添加_id主键

2. 连接mongoDB

1mongodb的使用方式是客户服务器模式，即使用一个客户端连接mongodb数据库（服务端）

1. 命令格式

mongodb://[username:password@]host1[:port1][,host2[:port2],...[,hostN[:portN]]][/[database][? options]]

解释：
mongodb:// 固定前缀 
username：账号，可不填 
password：密码，可不填 
host：主机名或ip地址，只有host主机名为必填项。 
port：端口，可不填，默认27017 
/database：连接某一个数据库 
?options：连接参数，key/value对

例子
mongodb://localhost 连接本地数据库27017端口
mongodb://root:itcast@localhost 使用用户名root密码为itcast连接本地数据库27017端口
mongodb://localhost,localhost:27018,localhost:27019，连接三台主从服务器，端口为27017、27018、27019

1.使用MongoDB自带的javascript shell（mongo.exe）连接

2. 使用studio3T连接

1. 前面已经介绍过了

3. 使用java连接

1. 添加依赖

<dependency> 
	<groupId>org.mongodb</groupId> 
	<artifactId>mongo‐java‐driver</artifactId> 
	<version>3.4.3</version> 
</dependency>

2. java 测试代码

@Test 
public void testConnection(){ 
	//创建mongodb 客户端 
	MongoClient mongoClient = new MongoClient( "localhost" , 27017 ); 
	//或者采用连接字符串 
	//MongoClientURI connectionString = new MongoClientURI("mongodb://root:root@localhost:27017"); 
	//MongoClient mongoClient = new MongoClient(connectionString); 
	//连接数据库
	MongoDatabase database = mongoClient.getDatabase("test"); 
	// 连接collection 
	MongoCollection<Document> collection = database.getCollection("student"); 
	//查询第一个文档 
	Document myDoc = collection.find().first(); 
	//得到文件内容 json串 
	String json = myDoc.toJson(); 
	System.out.println(json); 
}

3. 数据库（mongo.exe命令，客户端直接图形界面操作就行了）

1. 查询数据库

show dbs #查询全部数据库
db #显示当前数据库

2. 创建数据库

use DATABASE_NAME

例子：
use test02
有test02数据库则切换到此数据库，没有则创建。
注意： 
新创建的数据库不显示，需要至少包括一个集合。

3. 删除数据库（慎用！！！）

db.dropDatabase()

例子： 
删除test02数据库 
先切换数据库：use test02 
再执行删除：db.dropDatabase()

4. 集合（mongo.exe命令，客户端直接图形界面操作就行了）

集合相当于关系数据库中的表，一个数据库可以创建多个集合，一个集合是将相同类型的文档管理起来。

1. 创建集合

db.createCollection(name, options) 
name: 新创建的集合名称 
options: 创建参数

2. 删除集合

db.collection.drop() 
例子： 
db.student.drop() 删除student集合

5. 文档（mongo.exe命令，客户端直接图形界面操作就行了）

文档就是关系型数据库中的数据，但是它是json格式，比如下面的文档

{ 
	"_id" : ObjectId("5b2cc4bfa6a44812707739b5"), 
	"name" : "黑马程序员" 
}

1. 插入文档

插入命令： 
db.COLLECTION_NAME.insert(document)

每个文档默认以_id作为主键，主键默认类型为ObjectId（对象类型），mongodb会自动生成主键值。

例子：
db.student.insert({"name":"黑马程序员","age":10})

注意：同一个集合中的文档的key可以不相同！但是建议设置为相同的。

2. 更新文档

db.collection.update(
	<query>, 
	<update>, 
	<options> 
)
query:查询条件，相当于sql语句的where 
update：更新文档内容 
options：选项

1. 替换文档

# 将符合条件 "name":"北京黑马程序"的第一个文档替换为{"name":"北京黑马程序员","age":10}。

db.student.update({"name":"黑马程序员"},{"name":"北京黑马程序员","age":10})

2. $set修改器

使用$set修改器指定要更新的key，key不存在则创建，存在则更新。

将符合条件 "name":"北京黑马程序"的所有文档更新name和age的值。

db.student.update({"name":"黑马程序员"},{$set:{"name":"北京黑马程序员","age":10}},{multi:true})

multi：false表示更新第一个匹配的文档，true表示更新所有匹配的文档。

3. 删除文档

语法格式：
db.student.remove(<query>) 
query：删除条件，相当于sql语句中的where

1、删除所有文档 
db.student.remove({}) 
2、删除符合条件的文档 
db.student.remove({"name":"黑马程序员"})

4. 查询文档

语法格式：
db.collection.find(query, projection) 
query：查询条件，可不填 
projection：投影查询key，可不填

1、 查询全部
db.student.find()
2、查询符合条件的记录
查询name等为"黑马程序员"的文档。
db.student.find({"name":"黑马程序员"})
3、投影查询
只显示name和age两个key，_id主键不显示。
db.student.find({"name":"黑马程序员"},{name:1,age:1,_id:0})

6. 用户（mongo.exe命令，客户端直接图形界面操作就行了）

1. 创建用户

语法格式：
mongo>db.createUser(
{ user: "<name>", 
	pwd: "<cleartext password>", 
	customData: { <any information> }, 
	roles: [ { role: "<role>", db: "<database>" } | "<role>", 
		... 
	]} 
)

例子： 
创建root用户，角色为root
use admin 
db.createUser( 
	{ 
		user:"root", 
		pwd:"root", 
		roles:[{role:"root",db:"admin"}] 
	} 
)
内置角色如下：
	1. 数据库用户角色：read、readWrite; 
	2. 数据库管理角色：dbAdmin、dbOwner、userAdmin；
	3. 集群管理角色：clusterAdmin、clusterManager、clusterMonitor、hostManager；
	4. 备份恢复角色：backup、restore； 
	5. 所有数据库角色：readAnyDatabase、readWriteAnyDatabase、userAdminAnyDatabase、 dbAdminAnyDatabase 
	6. 超级用户角色：root

2. 查询用户

查询当前库下的所有用户： 
show users

3. 删除用户

语法格式： 
db.dropUser("用户名") 
例子： 
删除root1用户 
db.dropUser("root1")

4. 修改用户

语法格式：
db.updateUser(
 "<username>",
 { 
 	customData : { <any information> },
 	roles : [ 
 		{ role: "<role>", db: "<database>" } | "<role>", 
 		... 
 		], 
 	pwd: "<cleartext password>" 
 	},
 	writeConcern: { <write concern> })

例子： 
修改root用户的角色为readWriteAnyDatabase
use admin 
db.updateUser("root",{roles:[{role:"readWriteAnyDatabase",db:"admin"}]})

5. 修改密码

语法格式： db.changeUserPassword("username","newPasswd")
例子： 
修改root用户的密码为123
use admin 
db.changeUserPassword("root","123")

四、使用spring boot 对MongoDB增删改查

1. 环境搭建

1. 导入mongoDB数据（资料从这里下载即可https://download.csdn.net/download/grd_java/41201141）
   
   
   
   
2. 创建SpringBoot工程

1. 创建工程引入依赖
   

<parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.0.1.RELEASE</version>
    </parent>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-mongodb</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>
    </dependencies>

2. 配置文件
   

server:
  port: 31001
spring:
  application:
    name: xc‐service‐manage‐cms
  data:
    mongodb:
      uri: mongodb://localhost:27017
      database: xc_cms

3. 创建MongoDB对应的实体类
   

import lombok.Data;
import lombok.ToString;
import org.springframework.data.annotation.Id;
import org.springframework.data.mongodb.core.mapping.Document;

import java.util.Date;
import java.util.List;

/**
 * @Author: mrt.
 * @Description:
 * @Date:Created in 2018/1/24 10:04.
 * @Modified By:
 */
@Data
@ToString
@Document(collection = "cms_page")
public class CmsPage {
    /**
     * 页面名称、别名、访问地址、类型（静态/动态）、页面模版、状态
     */
    //站点ID
    private String siteId;
    //页面ID
    @Id
    private String pageId;
    //页面名称
    private String pageName;
    //别名
    private String pageAliase;
    //访问地址
    private String pageWebPath;
    //参数
    private String pageParameter;
    //物理路径
    private String pagePhysicalPath;
    //类型（静态/动态）
    private String pageType;
    //页面模版
    private String pageTemplate;
    //页面静态化内容
    private String pageHtml;
    //状态
    private String pageStatus;
    //创建时间
    private Date pageCreateTime;
    //模版id
    private String templateId;
    //参数列表
    private List<CmsPageParam> pageParams;
    //模版文件Id
//    private String templateFileId;
    //静态文件Id
    private String htmlFileId;
    //数据Url
    private String dataUrl;

}

import lombok.Data;
import lombok.ToString;

/**
 * @Author: mrt.
 * @Description:
 * @Date:Created in 2018/1/24 10:04.
 * @Modified By:
 */
@Data
@ToString
public class CmsPageParam {
    //参数名称
    private String pageParamName;
    //参数值
    private String pageParamValue;

}

4. 创建mapper类，操作数据库的类
   

import com.yzpnb.entity.mongodb.CmsPage;
import org.springframework.data.mongodb.repository.MongoRepository;

/**
 * MongoRepository<CmsPage,String>
 *     CmsPage 模型类
 *     String 主键 id 的类型
 */
public interface CmsPageRepository extends MongoRepository<CmsPage,String> {

}

5. 启动类
   
6. 测试类（代码再下面）
   

2. 常用逻辑代码

import com.xuecheng.framework.domain.cms.CmsPage;
import com.xuecheng.manage_cms.CmsApplication;
import com.xuecheng.manage_cms.dao.CmsPageRepository;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.data.domain.*;
import org.springframework.test.context.junit4.SpringRunner;

import java.util.List;


@RunWith(SpringRunner.class)
@SpringBootTest(classes = CmsApplication.class)
public class MongoDBTest {
    @Autowired
    private CmsPageRepository cmsPageRepository;

    /**
     * 查询全部
     */
    @Test
    public void testFindAll(){
        List<CmsPage> all = cmsPageRepository.findAll();
        System.out.println(all);
    }

    /**
     * 分页查询全部
     */
    @Test
    public void testFindAllByPage(){
        Pageable pageable = PageRequest.of(0,10);
        Page<CmsPage> all = cmsPageRepository.findAll(pageable);
        System.out.println(all);
    }

    /**
     * 根据条件分页查询
     */
    @Test
    public void testFindByExample(){
        //查询条件，通过对应实体类设置即可
        CmsPage cmsPage = new CmsPage();
        cmsPage.setSiteId("5a751fab6abb5044e0d19ea1");
        //模板ID
//        cmsPage.setTemplateId("5a962c16b00ffc514038fafd");
         cmsPage.setPageAliase("首页");

         Pageable pageable = PageRequest.of(0,10);//分页

        /**条件匹配器**/
        //设置针对pageAliase字段，为模糊匹配，只要包含搜索条件字符，就查出数据
        //页面别名模糊查询，需要自定义字符串的匹配器实现模糊查询
        // ExampleMatcher.GenericPropertyMatchers.contains() 包含
        // ExampleMatcher.GenericPropertyMatchers.startsWith()//开头匹配
        ExampleMatcher exampleMatcher = ExampleMatcher.matching()//创建条件匹配器
            .withMatcher("pageAliase",ExampleMatcher.GenericPropertyMatchers.contains());//如果不需要模糊匹配，可以省略

        // 创建条件实例
//        Example<CmsPage> example = Example.of(cmsPage,exampleMatcher);
        Example<CmsPage> example = Example.of(cmsPage,exampleMatcher);
        Page<CmsPage> all = cmsPageRepository.findAll(example, pageable);
        List<CmsPage> content = all.getContent();
        System.out.println(content);
    }
}

3. 页面静态化技术

需要freemarker技术支持：https://blog.csdn.net/grd_java/article/details/121314729

五、GridFS（在上面spring boot工程基础上）

GridFS

1. GridFS是MongoDB提供的用于持久化存储文件的模块，CMS使用MongoDB存储数据，使用GridFS可以快速集成 开发。
2. 它的工作原理是：

1. 在GridFS存储文件是将文件分块存储，文件会按照256KB的大小分割成多个块进行存储，GridFS使用两个集合
   （collection）存储文件，一个集合是chunks, 用于存储文件的二进制数据；一个集合是files，用于存储文件的元数据信息（文件名称、块大小、上传时间等信息）。

2. 从GridFS中读取文件要对文件的各各块进行组装、合并。

1. 存文件

    @Autowired
    GridFsTemplate gridFsTemplate;//注入GridFsTemplate对象
    @Test
    public void testGridFs() throws FileNotFoundException{
        //要存储的文件
        File file = new File("D:/index_banner.ftl");
        //定义输入流
        FileInputStream fileInputStream = new FileInputStream(file);
        //向GridFS存储文件
        ObjectId objectId = gridFsTemplate.store(fileInputStream, "轮播图测试文件01", "");
        //得到文件ID
        String fileId = objectId.toString();
        System.out.println(fileId);
    }

2. 取文件

1. 添加MongoDB配置类
   
2. 启动类保证扫描到了此类
   

import com.mongodb.MongoClient;
import com.mongodb.client.MongoDatabase;
import com.mongodb.client.gridfs.GridFSBucket;
import com.mongodb.client.gridfs.GridFSBuckets;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MongoConfig {

    @Value("${spring.data.mongodb.database}") String db;

    @Bean
    public GridFSBucket getGridFSBucket(MongoClient mongoClient){
        MongoDatabase database = mongoClient.getDatabase(db);
        GridFSBucket bucket = GridFSBuckets.create(database);
        return bucket;
    }
}

2. 编写测试代码
   

    @Autowired
    GridFSBucket gridFSBucket;

    @Test
    public void queryFile() throws IOException {
        String fileId = "6190b58dbce9161da8c72a96";
        //根据id查询文件
        GridFSFile gridFSFile = gridFsTemplate.findOne(Query.query(Criteria.where("_id").is(fileId)));
        //打开下载流对象
        GridFSDownloadStream gridFSDownloadStream = gridFSBucket.openDownloadStream(gridFSFile.getObjectId());
        //创建gridFsResource，用于获取流对象
        GridFsResource gridFsResource = new GridFsResource(gridFSFile,gridFSDownloadStream);
        //获取流中的数据
        String s = IOUtils.toString(gridFsResource.getInputStream(), "utf-8");
        System.out.println(s);
    }

3. 删除文件

    //删除文件
     @Test
    public void testDelFile() throws IOException {
        //根据文件id删除fs.files和fs.chunks中的记录
        gridFsTemplate.delete(Query.query(Criteria.where("_id").is("6190b58dbce9161da8c72a96")));
    }