mongodb 速成笔记

以下环境为mac osx + jdk 1.8 + mongodb v3.2.3

一、安装

brew安装方式是mac下最简单的方式

1 2	brew update brew  install  mongodb

其它OS上的安装请参考：https://docs.mongodb.org/manual/installation/

 

二、启动

2.1 最基本的启动

1

mongod

 不加任何参数时，db默认保存在/data/db目录(如果该目录不存在，启动会报错)，监听的端口是27017，且不启动安全认证机制(即：谁都可以连接，只要连接上来的用户都是管理员）

2.2 指定dbpath

1	mongod --dbpath ~ /data/db/mongo

指定dbpath后，数据文件将保存在指定的目录下（注意：该目录必须有读写权限）

2.3 指定端口

1	mongod --dbpath ~ /data/db/mongo  --port 12345

2.4 启用安全认证

1	mongod --dbpath ~ /data/db/mongo  --port 12345 --auth

这个下面还会仔细讲解，这里只要记得有--auth这个选项即可。

2.5 其它一些选项

1	mongod --help

如果想详细了解所有启动选项，可以加--help查看所有可选参数。

启动成功后，可以用 mongo 命令来连接

1 2 3 4

➜  ~ mongo MongoDB shell version: 3.2.4 connecting to:  test >

然后就可以直接使用各种命令来操作db了　

 

三、安全相关

不带--auth的启动方式是很可怕的，没有任何安全控制，一般只限于开发环境。生产环境肯定要开启安全认证，mongodb在安全认证的主要思路是：

先在某个库上创建用户(db.createUser) -> 将该用户授权(db.auth) -> mongod启动时指定--auth选项 -> mongo客户端连接时指定用户名、密码、认证db（或者连接时先不指定用户名、密码，连接上以后，再用db.auth切换到认证用户身份）

3.0 创建数据库

1

use mydb

跟mysql差不多，use 后加数据库名称即可，如果数据库不存在，会自动创建。假设以下的所有安全相关的操作，都是在mydb这个库下。

3.1 创建用户

切换到相对的db后，使用下面的命令创建用户

1 2 3

db.createUser( {  "user"  :  "admin" ,                   "pwd" :  "123456" ,                                 "roles"  : [  "readWrite" , "dbAdmin" , "userAdmin" ]})

这样就创建了一个名为admin的管理员，而且具备读写、db管理、用户管理权限。如果想知道mongo默认有哪些roles角色，可参考：https://docs.mongodb.org/manual/reference/built-in-roles/#built-in-roles

3.2 授权

1 2 3 4

db.auth({     user:  "admin" ,     pwd :  "123456" })

3.3 用--auth 重启mongod

1	mongod --auth

3.4 客户端连接时，指定安全信息

1	mongo localhost:27017 /mydb  -u admin -p 123456 --authenticationDatabase mydb

大家参考上面的命令修改相关参数（比如：端口号之类的），连接上去后，可以尝试

1	db.orders.insert({ 'orderId' :1, 'productName' : 'iphone' })

 看看能否写入数据。

注：作为对比，大家还可以创建一个其它只有read权限的用户(比如：guest/guest)，同样的姿势连接上去，再insert试试，正常情况话，应该写入失败。

安全相关的更详细信息，请参考 ：https://docs.mongodb.org/manual/core/authentication/

 

四、CRUD操作

一般教程上都是讲解如果在mongo终端下使用命令来做CRUD，但是更多情况下，我们是在代码里完成这些操作的，所以下面说下如何利用spring-data-mongo来操作mongo，以gradle项目为例，下面的代码参考了spring官方的示例代码

4.1 build.gradle文件

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34

group  'com.cnblogs.yjmyzz' version  '1.0-SNAPSHOT'   apply plugin:  'java' apply plugin:  'application' apply plugin:  'spring-boot'   sourceCompatibility = 1.8   buildscript {      repositories {          maven {              url  'http://maven.oschina.net/content/groups/public/'          }      }        dependencies {          classpath( "org.springframework.boot:spring-boot-gradle-plugin:1.3.3.RELEASE" )      } }   repositories {      maven {          url  'http://maven.oschina.net/content/groups/public/'      } }   dependencies {      compile  'org.springframework.data:spring-data-mongodb:1.8.4.RELEASE'      compile( "org.springframework.boot:spring-boot-starter-actuator" )      testCompile group:  'junit' , name:  'junit' , version:  '4.12' }   mainClassName =  'com.cnblogs.yjmyzz.mongo.Application'

 其实关键的只有一行：

1	compile  'org.springframework.data:spring-data-mongodb:1.8.4.RELEASE'

4.2 spring配置文件

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <beans xmlns="http://www.springframework.org/schema/beans"
 3        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4        xmlns:mongo="http://www.springframework.org/schema/data/mongo"
 5        xsi:schemaLocation=
 6                "http://www.springframework.org/schema/data/mongo
 7           http://www.springframework.org/schema/data/mongo/spring-mongo-1.0.xsd
 8           http://www.springframework.org/schema/beans
 9           http://www.springframework.org/schema/beans/spring-beans-3.0.xsd">
10 
11     <mongo:db-factory id="mongoDbFactory"
12                       host="localhost"
13                       port="27017"
14                       dbname="yjmyzz"
15                       username="admin"
16                       password="123456"/>
17 
18     <bean id="mongoTemplate" class="org.springframework.data.mongodb.core.MongoTemplate">
19         <constructor-arg name="mongoDbFactory" ref="mongoDbFactory"/>
20     </bean>
21 
22 </beans>

4.3 定义Model

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53

package  com.cnblogs.yjmyzz.mongo.model;   import  org.springframework.data.annotation.Id;     public  class  Customer {        @Id      private  String id;        private  String firstName;      private  String lastName;        public  Customer() {}        public  Customer(String firstName, String lastName) {          this .firstName = firstName;          this .lastName = lastName;      }        @Override      public  String toString() {          return  "Customer{"  +                  "id='"  + id + '\ ''  +                  ", firstName='"  + firstName + '\ ''  +                  ", lastName='"  + lastName + '\ ''  +                  '}' ;      }        public  String getId() {          return  id;      }        public  void  setId(String id) {          this .id = id;      }        public  String getFirstName() {          return  firstName;      }        public  void  setFirstName(String firstName) {          this .firstName = firstName;      }        public  String getLastName() {          return  lastName;      }        public  void  setLastName(String lastName) {          this .lastName = lastName;      } }

4.4 定义DAO接口

+ View Code

这里有一些默认的约定要理解，比如上面的findByLastName这个方法，执行时会自动按Customer的lastName属性来find数据。更详细的方法名与类属性的默认约定，可参考:http://docs.spring.io/spring-data/data-mongo/docs/1.8.4.RELEASE/reference/html/

4.5 Application使用示例

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104

package  com.cnblogs.yjmyzz.mongo;   import  com.cnblogs.yjmyzz.mongo.model.Customer; import  com.cnblogs.yjmyzz.mongo.repository.CustomerRepository; import  org.springframework.beans.factory.annotation.Autowired; import  org.springframework.beans.factory.annotation.Configurable; import  org.springframework.boot.CommandLineRunner; import  org.springframework.boot.SpringApplication; import  org.springframework.boot.autoconfigure.SpringBootApplication; import  org.springframework.context.annotation.ImportResource; import  org.springframework.data.domain.Page; import  org.springframework.data.domain.PageRequest; import  org.springframework.data.mongodb.core.MongoTemplate; import  org.springframework.data.mongodb.core.query.Criteria; import  org.springframework.data.mongodb.core.query.Query;   import  java.util.List;   @Configurable () @SpringBootApplication @ImportResource ( "classpath:spring-context.xml" ) public  class  Application  implements  CommandLineRunner {        @Autowired      private  CustomerRepository repository;        @Autowired      MongoTemplate mongoTemplate;        public  static  void  main(String[] args) {            SpringApplication.run(Application. class , args);   //        ApplicationContext ctx = SpringApplication.run(Application.class, args); // //        System.out.println("getBeanDefinitionNames ==> "); //        for (String beanName : ctx.getBeanDefinitionNames()) { //            System.out.println(beanName); //        } //        System.out.println("<==");        }        @Override      public  void  run(String... args)  throws  Exception {            repository.deleteAll();            // save a couple of customers          repository.save( new  Customer( "Alice" ,  "Smith" ));          repository.save( new  Customer( "Bob" ,  "Smith" ));          repository.save( new  Customer( "张" ,  "三" ));          repository.save( new  Customer( "李" ,  "四" ));          repository.save( new  Customer( "王" ,  "五" ));          repository.save( new  Customer( "赵" ,  "六" ));          repository.save( new  Customer( "周" ,  "七" ));          repository.save( new  Customer( "杨" ,  "八" ));            // fetch all customers          System.out.println( "Customers found with findAll():" );          System.out.println( "-------------------------------" );          for  (Customer customer : repository.findAll()) {              System.out.println(customer);          }          System.out.println();            // fetch an individual customer          System.out.println( "Customer found with findByFirstName('Alice'):" );          System.out.println( "--------------------------------" );          System.out.println(repository.findByFirstName( "Alice" ));            System.out.println( "Customers found with findByLastName('Smith'):" );          System.out.println( "--------------------------------" );          for  (Customer customer : repository.findByLastName( "Smith" )) {              System.out.println(customer);          }            System.out.println( "分页测试==>" );          Page<Customer> pageData = repository.findAll( new  PageRequest( 0 ,  4 ));          for  (Customer c : pageData) {              System.out.println(c);          }          System.out.println( "----------" );          System.out.println(String.format( "第%d页 , 总页数:%d , 总记录数:%d , %d条/页" ,                  pageData.getNumber() +  1 ,                  pageData.getTotalPages(),                  pageData.getTotalElements(),                  pageData.getSize()          ));            //按条件动态查询          Customer c = mongoTemplate.findOne( new  Query(Criteria.where( "firstName" ).is( "杨" )), Customer. class );          System.out.println(c);            System.out.println( "----------" );            List<Customer> list = mongoTemplate.find( new  Query(Criteria.where( "firstName" ).in( "李" , "赵" )), Customer. class );            for  (Customer item : list) {              System.out.println(item);          }      }   }

github上已经开源了该项目：https://github.com/yjmyzz/spring-mongo-sample 供有需要的同学参考