mongodb快速入门

通过mongdb初始,我们对mongodb有了一个基本的认识,接下来看一下究竟如何使用。
本部分包含的内容包括:
1、mongodb在mac的安装,命令行及客户端工具的简单介绍;
2、在spring中如何使用mongodb,增删改查示例;
3、mongodb原生api的使用,增删改查示例;
4、mongodb连接池的学习;

-------------------------------------------------------------------------------------------------------------------------------------------------
1、 下载安装及工具简单介绍
1、从官网下载安装包https://www.mongodb.com/download-center,解压到本地合适文件夹;
2、手动创建data目录以及logs跟logs/mongodb.log文件;
3、在mongodb安装目录创建etc目录,并在其下创建mongodb.conf文件,内容见下;
4、配置环境变量,export PATH=${PATH}:/software/mongodb-osx-x86_64-4.0.10/bin;
5、到bin目录执行./mongod -f ../etc/mongod.conf启动,或者nohup ./mongod -f ../etc/mongod.conf & 后台启动;
mongodb.conf内容如下:
#mongodb config file
dbpath=/software/mongodb-osx-x86_64-4.0.10/data/db/ #数据存放目录
logpath=/software/mongodb-osx-x86_64-4.0.10/logs/mongod.log #日志存放目录
logappend = true #以天为单位,自动切割日志
port = 27017
fork = true
auth = false
下载官方工具MongoDB Compass,启动后进行连接,过程略;
命令行及compass工具使用:
命令行:
1、连接数据库,./mongo ip地址:端口号,连接本地可以省略地址跟端口号,注意启动命令是mongod,连接命令是mongo

mongodb快速入门_第1张图片 

2、查看当前有几个数据库,show dbs ,类似于mysql的show database;
3、切换数据库,use 库名;
4、查看库中所有表,show collections;若当前库没有表,则显示为空;
5、往表中随便插入一条数据,db.myusers.insert({"name":"张三"})

mongodb快速入门_第2张图片

 这里我们注意一下,show dbs的时候,并没有mytest这个库,我们直接use mytest,mongodb并没有报错,而且我们可以直接insert;这一点跟mysql是不一样的,mongodb可以不用创建库,直接use之后insert的时候回自动创建该库,若没有insert操作,该库并不会实际创建;而且可以看到,对于插入的数据,mongodb自动生成了id;

compass连接本地,可以在左侧看到当前实例的所有库,右侧则为查询展示内容,list为mongo的josn视图,table为将数据展示为传统的关系库表视图;,上方的filter可以书写查询条件,另外还有查询的执行计划,索引等内容,稍后详述;我们刚才加入的数据:
mongodb快速入门_第3张图片
2、spring 集成mongodb使用
  目标:利用spring提供的mongodb的api实现对单表的增删改查
  1、创建spring boot项目,pom文件添加

    org.springframework.boot
    spring-boot-starter-data-mongodb


    org.springframework.boot
    spring-boot-starter-web


    org.mongodb
    mongo-java-driver
    3.8.0

  2、application.yml中添加

spring:
  data:
    mongodb:
      uri: mongodb://localhost:27017/wzy
  3、初始化数据:
  数据脚本如下:本文所采用的数据已被本地多次测试修改,但结构未发生变化,脚本参考如下:
db.users.drop();
var user1 = {
        "username" : "张三",
        "country" : "china",
        "address" : {
                "aCode" : "411000",
                "add" : "长沙"
        },
        "favorites" : {
                "movies" : ["杀破狼2","战狼","雷神1"],
                "cites" : ["长沙","深圳","上海"]
        },
        "age" : 18,
	"salary":NumberDecimal("18889.09"),
       "lenght" :1.79
};
var user2 = {
        "username" : "李四",
        "country" : "English",
        "address" : {
                "aCode" : "311000",
                "add" : "地址"
        },
        "favorites" : {
                "movies" : ["复仇者联盟","战狼","雷神1"],
                "cites" : ["西安","东京","上海"]
        },
        "age" : 24,
       "salary":NumberDecimal("7889.09"),
       "lenght" :1.35
};
var user3 ={
        "username" : "王五",
        "country" : "japan",
        "address" : {
                "aCode" : "411000",
                "add" : "长沙"
        },
        "favorites" : {
                "movies" : ["肉蒲团","一路向西","倩女幽魂"],
                "cites" : ["东莞","深圳","东京"]
        },
        "age" : 22,
       "salary":NumberDecimal("6666.66"),
       "lenght" :1.85
};
var user4 =
{
        "username" : "马六",
        "country" : "USA",
        "address" : {
                "aCode" : "411000",
                "add" : "长沙"
        },
        "favorites" : {
                "movies" : ["蜘蛛侠","钢铁侠","蝙蝠侠"],
                "cites" : ["青岛","东莞","上海"]
        },
        "age" : 20,
       "salary":NumberDecimal("6398.22"),
       "lenght" :1.77
};

var user5 =
{
        "username" : "test",
        "country" : "UK",
        "address" : {
                "aCode" : "411000",
                "add" : "TEST"
        },
        "favorites" : {
                "movies" : ["蜘蛛侠","钢铁侠","蝙蝠侠"],
                "cites" : ["青岛","东莞","上海"]
        },
       "salary":NumberDecimal("1969.88")
};

db.users.insert(user1);
db.users.insert(user2);
db.users.insert(user3);
db.users.insert(user4);
db.users.insert(user5);

   4、创建实体bean

  其中,@Getter等注解来自lombok
@ToString
@Getter
@Setter
@Generated
@Builder
@Document(collection = "users")
public class User {
@Id
private String id;
    //姓名
    @Field("username")
    private String username;
    //国籍
    private String country;
    //年龄
    private int age;
    //薪水
    private BigDecimal salary;
    //身高
    private Double length;
    //地址
    private Address address;
    //爱好
    private HashMap favourites;
}

  5、创建service

@Service
public class MongoTestService {
    @Autowired
    private MongoTemplate mongoTemplate;
    //查询
    public User getUserByName(String name){
        Query query = new Query();
        query.addCriteria(Criteria.where("username").is(name));
        User user = mongoTemplate.findOne(query, User.class);
        return user;
    }

    //插入
    public void insertUser(){
        HashMap map = new HashMap();
        map.put("movies", Arrays.asList("决战天门","倩女幽魂"));
        map.put("cities", Arrays.asList("大理","拉萨"));
        User user = User.builder()
                .username("luochengwu")
                .age(20)
                .country("china")
                .address(new Address("01002",""))
                .favourites(map)
                .salary(new BigDecimal("2345.67"))
                .build();
        mongoTemplate.save(user);
    }

    //更新
    public void updateUser(){
        //把李四年龄修改为30
        Query query1 = new Query();
        query1.addCriteria(Criteria.where("username").is("李四"));
        List lisi1 = mongoTemplate.find(query1,User.class);
        System.out.println("before update --------"+lisi1.get(0).toString());
        Update update1 = new Update();
        update1.set("age",30);
        UpdateResult result =mongoTemplate.updateMulti(query1,update1,User.class);
        List lisi11 = mongoTemplate.find(query1,User.class);
        System.out.println("after update --------"+result);
        System.out.println("after user --------"+lisi11.get(0));

        //略复杂的条件
        //住在横滨的日本人,喜欢的城市添加东京
        Query query2 = new Query();
        query2.addCriteria(Criteria.where("country").is("japan").and("address.add").is("横滨"));
        User user1 = mongoTemplate.findOne(query2,User.class);
        System.out.println("before update ------"+user1);
        Update update2 = new Update();
        update2.addToSet("favourites.cities","东京");
        UpdateResult result2 = mongoTemplate.updateMulti(query2,update2,User.class);
        User user2 = mongoTemplate.findOne(query2,User.class);
        System.out.println("after update --------"+result2);
        System.out.println("after user --------"+user2);
    }

    //删除
    public void deleteUser(){
        //删掉国籍为uk,且年龄为22的人
        Query query = new Query();
        query.addCriteria(Criteria.where("country").is("UK").and("age").is(22));
        User user = mongoTemplate.findOne(query,User.class);
        System.out.println("待删除的用户 ------" + user);
        DeleteResult result = mongoTemplate.remove(query,User.class);
        System.out.println("remove response ------"+ result);
        User delUser = mongoTemplate.findOne(query,User.class);
        System.out.println("query after delete ------" + delUser);
    }
}

  所碰到的问题:
  1、java跟mongodb数据类型转换的问题,一般java的数据类型跟数据库(比如mysql)的数据类型对应关系,数据库驱动已经帮我们做好了,那个“方言”的配置就是。mongodb貌似做的不全,有些是需要我们自己进行配置的,比如本例中的BigDecimal跟Decimal128;
  默认报错:
mongodb快速入门_第4张图片
  解决办法:添加converter
@Configuration
public class MongodbConfig extends AbstractMongoConfiguration {
    @Value("${spring.data.mongodb.uri}")
    private String dburi ;
    @Override
    public MongoClient mongoClient() {
        MongoClient mongoClient = new MongoClient();
        return mongoClient;
    }
    @Override
    protected String getDatabaseName() {
        int index = dburi.lastIndexOf("/")+1;
        return dburi.substring(index);
    }
    @Bean
    public MappingMongoConverter mappingMongoConverter(){
        DefaultDbRefResolver dbRefResolver = new DefaultDbRefResolver(this.mongoDbFactory());
        MappingMongoConverter converter = new MappingMongoConverter(dbRefResolver, this.mongoMappingContext());
        List list = new ArrayList<>();
        list.add(new BigDecimalToDecimal128Converter());
        list.add(new Decimal128ToBigDecimal());
        converter.setCustomConversions(new MongoCustomConversions(list));
        return converter;
    }
    @Bean
    public MongoMappingContext mongoMappingContext(){
        MongoMappingContext mappingContext = new MongoMappingContext();
        return mappingContext;
    }
    @Bean
    public MongoTemplate mongoTemplate(){
        return new MongoTemplate(this.mongoDbFactory(),this.mappingMongoConverter());
    }
}
 
     
    

  2、map跟hashmap的问题,被更新字段的数据类型必须明确。写Map报错:

mongodb快速入门_第5张图片
  解决办法,将相关字段改为实现类HashMap,而不是用接口;这个当时困扰了一下,开始的时候没看懂这个异常;
  3、double跟Double的问题,由于mongodb数据结构的自由,有些记录可能缺少某些字段,也就是字段值为null,如果该字段为引用类型是没有问题的,但若该字段为int,double等基本数据类型时,会发生类型转换错误;
  解决办法,将字段改为包装类;so,pojo的各个属性最好为引用类型而不是简单类型,在使用关系数据库的时候也应该如此,有些字段(比如年龄,分数,价钱等),没填写跟值为0显然是两个概念。
3、mongodb自带的原生api增删改查
public class DocumentTest {
    private Logger log = LoggerFactory.getLogger(DocumentTest.class);
    private MongoDatabase db;
    private MongoCollection collection;
    private MongoClient client;

    @Before
    public void init(){
        client = new MongoClient("localhost");
        db = client.getDatabase("wzy");
        collection = db.getCollection("users");
    }

    //新增
    @Test
    public void insertTest(){
        Document doc1 = new Document();
        doc1.append("username","cang");
        doc1.append("age",20);
        doc1.append("country","japan");
        doc1.append("length",1.77f);
        doc1.append("salary",new BigDecimal("6565.22"));

        //对象
        Map address = new HashMap<>();
        address.put("aCode","01001");
        address.put("add","大板");
        doc1.append("address",address);

        //数组
        Map fav = new HashMap<>();
        fav.put("movies", Arrays.asList("大决战","天龙"));
        fav.put("citys", Arrays.asList("杭州","苏州"));
        doc1.append("favourites",fav);

        collection.insertOne(doc1);
//        collection.insertMany();
    }

    //查询
    @Test
    public void queryTest(){//{"favourites.cites":["长沙","上海"]}
        List list = new ArrayList<>();
        //mongo查询结果遍历接口
        Block block = new Block() {
            @Override
            public void apply(Document document) {
                log.info(document.toJson());
                list.add(document);
            }
        };
        FindIterable find1 = collection.find(all("favourites.cites",Arrays.asList("长沙","上海")));
        find1.forEach(block);
        log.info("结果有{}条", list.size());

        list.removeAll(list);
        //like '%s%',需要正则,  like '%s%' and (country = 'English' or country='USA')
        String regexStr = ".*s.*"; //s前后都可以有任意字符
        Bson regex = regex("username",regexStr);
        Bson or = or(eq("country","English"),eq("country","USA"));
        FindIterable find2 = collection.find(and(regex,or));
        find2.forEach(block);
        log.info("查询结果有{}条",list.size());

    }

    //更新
    @Test
    public void updateTest(){
        //更新单个字段
        UpdateResult result = collection.updateMany(eq("username","cang"),new Document("$set",new Document("age",6)));
        //替换整个文档
//        UpdateResult result = collection.updateMany(eq("username","cang"),new Document(new Document("age",6)));

        UpdateResult result1 = collection.updateMany(eq("favourites.citys","杭州"),
                addEachToSet("favourites.movies",Arrays.asList("小电影")));

        log.info("更新了{}条",result1.getModifiedCount());
    }

    //删除
    @Test
    public void deleteTest(){
        DeleteResult result = collection.deleteMany(Filters.eq("username","luochengwu"));
        log.info("删除了{}行",result.getDeletedCount());
        DeleteResult result1 = collection.deleteMany(and(gt("age",8),lt("age",28)));
        log.info("删除了{}行",result1.getDeletedCount());
    }
}
  问题:经过前边对数据类型的趟坑,这里倒是没遇到什么异常;该部分最大的问题是对mongodb提供的原生api的不熟悉,尤其多个条件如何组合,and,or,exist的如何表达,文档整体更新跟局部更新如何处理等,这个感觉没什么办法,只能多多使用慢慢熟悉了;
4、mongodb连接池
  mongodb团队已经帮我们做好了一个连接池,以供我们直接使用。使用方式也很简单,就是在获取client的时候将连接池参数对象传进去即可。
  连接池参数的设置是通过构造器模式来实现的,因为参数实在是比较多,我们可以根据自己需要进行自由设置。比如在第3步的单元测试类中,我们可以这样使用连接池:
@Before
public void init(){
    MongoClientOptions mco = MongoClientOptions.builder()
            .writeConcern(WriteConcern.ACKNOWLEDGED)
            .minConnectionsPerHost(100)
            .threadsAllowedToBlockForConnectionMultiplier(5)
            .maxWaitTime(120000)
            .connectTimeout(10000)
            .build();
    client = new MongoClient(new ServerAddress("localhost",27017), mco);
    db = client.getDatabase("wzy");
    collection = db.getCollection("users");
}
-------------------------------------------------------------------------------------------------
  以上,我们练习了spring template跟mongo原生api两种操作mongodb的方式。使用起来,要跟sql一样有查询条件,有and,or,like等,但显然,其语法跟细节跟sql是完全不想关的,精通sql跟熟练使用mongodb没有半毛钱关系。实际上,mongodb是有挺多细节需要注意的,我们稍后将在典型场景中进行详述。
 

 

你可能感兴趣的:(mongodb快速入门)