当前位置： 首页 > news >正文

ODB安装与使用

news 2025/7/23 23:31:21

目录

一.ODB2.5 版本安装：

安装 build2：

安装 odb-compiler

安装 mysql 和客户端开发包

安装 boost profile 库

总体打包安装：

总体卸载：

总体升级：

二.ODB编程

三.测试样例

四.总结

一.ODB2.5 版本安装：

整个安装过程在 3 - 5 小时左右， 视网络情况而定。

安装 build2：

        因为 build2 安装时，有可能会版本更新，从 16 变成 17，或从 17 变 18，因此注意，先从 build2 官网查看安装步骤...

安装步骤：https://build2.org/install.xhtml#unix

 curl -sSfO https://download.build2.org/0.17.0/build2-install-0.17.0.sh
sh build2-install-0.17.0.sh

安装中因为网络问题，超时失败，解决：将超时时间设置的更长一些

sh build2-install-0.17.0.sh --timeout 1800

安装 odb-compiler

sudo apt-get install gcc-11-plugin-dev
mkdir odb-build && cd odb-build
bpkg create -d odb-gcc-N cc
\config.cxx=g++ \config.cc.coptions=-O3 \config.bin.rpath=/usr/lib \config.install.root=/usr/ \config.install.sudo=sudo
cd odb-gcc-N
bpkg build odb@https://pkg.cppget.org/1/beta
bpkg test odb
bpkg install odb
odb --version
#如果报错了，找不到 odb，那就在执行下边的命令
sudo echo 'export PATH=${PATH}:/usr/local/bin' >> ~/.bashrc
export PATH=${PATH}:/usr/local/bin
odb --version

安装 ODB 运行时库：

cd ..bpkg create -d libodb-gcc-N cc
\config.cxx=g++ \config.cc.coptions=-O3 \config.install.root=/usr/ \config.install.sudo=sudocd libodb-gcc-Nbpkg add https://pkg.cppget.org/1/betabpkg fetchbpkg build libodbbpkg build libodb-mysql

安装 mysql 和客户端开发包

sudo apt install mysql-server
sudo apt install -y libmysqlclient-dev

配置 mysql

sudo vim /etc/my.cnf 或者 /etc/mysql/my.cnf 有哪个修改哪个就行
#添加以下内容
[client]
default-character-set=utf8
[mysql]
default-character-set=utf8
[mysqld]
character-set-server=utf8
bind-address = 0.0.0.0

修改 root 用户密码

sudo cat /etc/mysql/debian.cnf
sudo mysql -u debian-sys-maint -pmysql> ALTER USER 'root'@'localhost' IDENTIFIED WITHmysql_native_password BY 'xxxxxx';mysql> FLUSH PRIVILEGES;

重启 mysql，并设置开机启动

sudo systemctl restart mysql
sudo systemctl enable mysql

安装 boost profile 库

bpkg build libodb-boost

总体打包安装：

bpkg install --all --recursive

总体卸载：

bpkg uninstall --all --recursive

总体升级：

bpkg fetch
bpkg status
bpkg uninstall --all --recursive
bpkg build --upgrade --recursive
bpkg install --all --recursive

二.ODB编程

        ODB（Open Database）在数据元结构定义时，使用预处理器指令（#pragma）来提供元数据，这些元数据指示如何将 C++类型映射到数据库模式。这些#pragma 指令是在 C++代码中使用的，它们不是 C++语言的一部分，而是特定于 ODB 编译器的扩展。以下是 ODB 中常用的一些#pragma 指令：

1. #pragma db object:

        ￮ 用于声明一个类是数据库对象，即这个类将映射到数据库中的一个表。

2. #pragma db table("table_name"):

        ￮ 指定类映射到数据库中的表名。如果不指定，则默认使用类名。

3. #pragma db id:

        ￮ 标记类中的一个成员变量作为数据库表的主键。

4. #pragma db column("column_name"):

        ￮ 指定类成员映射到数据库表中的列名。如果不指定，则默认使用成员变量的名字。

5. #pragma db view:

        ￮ 用于声明一个类是一个数据库视图，而不是一个表。

6. #pragma db session:

        ￮ 用于声明一个全局或成员变量是数据库会话。

7. #pragma db query("query"):

        ￮ 用于定义自定义的查询函数。

8. #pragma db index("index_name"):

        ￮ 指定成员变量应该被索引。

9. #pragma db default("default_value"):

        ￮ 指定成员变量的默认值。

10. #pragma db unique:

        ￮ 指定成员变量或一组变量应该具有唯一性约束。

11. #pragma db not_null:

        ￮ 指定成员变量不允许为空。

12. #pragma db auto:

        ￮ 指定成员变量的值在插入时自动生成（例如，自动递增的主键）。

13. #pragma db transient:

        ￮ 指定成员变量不应该被持久化到数据库中。

14. #pragma db type("type_name"):

        ￮ 指定成员变量的数据库类型。

15. #pragma db convert("converter"):

        ￮ 指定用于成员变量的自定义类型转换器。

16. #pragma db pool("pool_name"):

        ￮ 指定用于数据库连接的连接池。

17. #pragma db trigger("trigger_name"):

        ￮ 指定在插入、更新或删除操作时触发的触发器。

三.测试样例

编写数据结构文件： student.hxx

#pragma once
#include <string>
#include <cstddef> // std::size_t
#include <boost/date_time/posix_time/posix_time.hpp>
#include <odb/nullable.hxx>
#include <odb/core.hxx>#pragma db object
class Student
{
public:Student() {}Student(unsigned long sn, const std::string &name, unsigned short age, unsigned long cid) : _sn(sn), _name(name), _age(age), _classes_id(cid) {}void sn(unsigned long num) { _sn = num; }unsigned long sn() { return _sn; }void name(const std::string &name) { _name = name; }std::string name() { return _name; }void age(unsigned short num) { _age = num; }odb::nullable<unsigned short> age() { return _age; }void classes_id(unsigned long cid) { _classes_id = cid; }unsigned long classes_id() { return _classes_id; }private:friend class odb::access;
#pragma db id autounsigned long _id;
#pragma db uniqueunsigned long _sn;std::string _name;odb::nullable<unsigned short> _age;
#pragma db indexunsigned long _classes_id;
};#pragma db object
class Classes
{
public:Classes() {}Classes(const std::string &name) : _name(name) {}void name(const std::string &name) { _name = name; }std::string name() { return _name; }private:friend class odb::access;
#pragma db id autounsigned long _id;std::string _name;
};// 查询所有的学生信息，并显示班级名称
#pragma db view object(Student)                                      \object(Classes = classes : Student::_classes_id == classes::_id) \query((?))
struct classes_student
{
#pragma db column(Student::_id)unsigned long id;
#pragma db column(Student::_sn)unsigned long sn;
#pragma db column(Student::_name)std::string name;
#pragma db column(Student::_age)odb::nullable<unsigned short> age;
#pragma db column(classes::_name)std::string classes_name;
};// // 下面这两个也是需要放开的吗
// // 只查询学生姓名  ,   (?)  外部调用时传入的过滤条件
#pragma db view query("select name from Student" + (?))
struct all_name
{std::string name;
};// // #pragma db view query("select name from Student where id = 1")
// // struct all_name
// // {
// //     std::string name;
// // };// #pragma db view object(Student) query((?))
// struct all_name
// {
//     // std::string name;
//     unsigned long id;
//     unsigned long sn;
//     std::string name;
//     odb::nullable<unsigned short> age;
//     unsigned long classes_id;
// };// odb -d mysql --std c++11 --generate-query --generate-schema --profile boost/date-time student.hxx

        最下面有编译这个hxx文件的命令。

编写测试文件：main.cc

#include <string>
#include <memory>  // std::auto_ptr
#include <cstdlib> // std::exit
#include <iostream>
#include <gflags/gflags.h>
#include <odb/database.hxx>
#include <odb/mysql/database.hxx>
#include <odb/tracer.hxx>#include "student.hxx"
#include "student-odb.hxx"DEFINE_string(host, "127.0.0.1", "这是Mysql服务器地址");
DEFINE_int32(port, 3306, "这是Mysql服务器端口"); //
DEFINE_string(db, "test", "数据库默认库名称");
DEFINE_string(user, "root", "这是Mysql用户名");
DEFINE_string(pswd, "123456789ylj.", "这是Mysql密码");
DEFINE_string(cset, "utf8", "这是Mysql客户端字符集");
DEFINE_int32(max_pool, 3, "这是Mysql连接池最大连接数量");void insertClass(odb::mysql::database& db)
{try{//开启一个事务odb::transaction trans(db.begin());Classes c1("一年级一班");Classes c2("一年级二班");db.persist(c1);db.persist(c2);//提交事务trans.commit();}catch(std::exception& e){std::cout << e.what() << std::endl;}
}void insertStudent(odb::mysql::database& db)
{try{//开启一个事务odb::transaction trans(db.begin());Student s1(1, "张三", 18, 1);Student s2(2, "李四", 19, 1);Student s3(3, "王五", 18, 1);Student s4(4, "赵六", 15, 2);Student s5(5, "刘七", 18, 2);Student s6(6, "孙八", 23, 2);db.persist(s1);db.persist(s2);db.persist(s3);db.persist(s4);db.persist(s5);db.persist(s6);//提交事务trans.commit();}catch(std::exception& e){std::cout << e.what() << std::endl;}
}Student selectStudent(odb::mysql::database& db)
{Student ret;try{   //开启一个事务odb::transaction trans(db.begin());typedef odb::query<Student> query;typedef odb::result<Student> result;result r(db.query<Student>(query::name == "张三"));if(r.size() != 1){std::cerr << "数据量不对!\n";return Student();}ret = *r.begin();//提交事务trans.commit();}catch(std::exception& e){std::cout << e.what() << std::endl;return Student();}return ret;
}void removeStudent(odb::mysql::database& db)
{try {//获取事务对象开启事务odb::transaction trans(db.begin());typedef odb::query<Student> query;db.erase_query<Student>(query::classes_id == 2);//5. 提交事务trans.commit();}catch (std::exception &e) {std::cout << "更新学生数据出错：" << e.what() << std::endl;}
}void classesStudent(odb::mysql::database& db)
{try{   //开启一个事务odb::transaction trans(db.begin());typedef odb::query<struct classes_student> query;typedef odb::result<struct classes_student> result;result r = db.query<struct classes_student>();for(auto it = r.begin();it != r.end();it++){std::cout << it->id << std::endl;std::cout << it->sn << std::endl;std::cout << it->name << std::endl;std::cout << *it->age << std::endl;std::cout << it->classes_name << std::endl;}//提交事务trans.commit();}catch(std::exception& e){std::cout << e.what() << std::endl;}
}void allStudent(odb::mysql::database& db)
{try{//开启一个事务odb::transaction trans(db.begin());typedef odb::query<Student> query;typedef odb::result<struct all_name> result;result r(db.query<struct all_name>());for(auto it = r.begin();it != r.end();it++){std::cout << it->name << std::endl;}//提交事务trans.commit();}catch(std::exception& e){std::cout << e.what() << std::endl;}
}int main(int argc, char* argv[])
{google::ParseCommandLineFlags(&argc, &argv, true);//1.构建连接池工厂配置对象std::unique_ptr<odb::mysql::connection_pool_factory> cpf(new odb::mysql::connection_pool_factory(FLAGS_max_pool ,0));//2.构造数据库操作对象odb::mysql::database db(FLAGS_user, FLAGS_pswd, FLAGS_db,FLAGS_host, FLAGS_port, "", FLAGS_cset,0, std::move(cpf));//4.数据操作// insertClass(db);// insertStudent(db);// auto out = selectStudent(db);// std::cout << out.name() << std::endl;// std::cout << *out.age() << std::endl;// std::cout << out.sn() << std::endl;// std::cout << out.classes_id() << std::endl;// removeStudent(db);// classesStudent(db);allStudent(db);return 0;
}
c++ -o main main.cc student-odb.cxx -lodb-mysql -lodb -lodb-boost -lgflags

        以上一条为编译命令。

目录结构：

内层CMakeLists.txt:

# 1. 添加cmake版本说明
cmake_minimum_required(VERSION 3.1.3)
# 2. 声明工程名称
project(odb-test)# 3. 检测并生成ODB框架代码
#   1. 添加所需的odb映射代码文件名称
set(odb_path ${CMAKE_CURRENT_SOURCE_DIR}/entity)
set(odb_files student.hxx)
#   2. 检测框架代码文件是否已经生成
set(odb_hxx "")
set(odb_cxx "")
set(odb_srcs "")
foreach(odb_file ${odb_files})
#   3. 如果没有生成，则预定义生成指令 -- 用于在构建项目之间先生成框架代码string(REPLACE ".hxx" "-odb.hxx" odb_hxx ${odb_file})string(REPLACE ".hxx" "-odb.cxx" odb_cxx ${odb_file})if (NOT EXISTS ${CMAKE_CURRENT_BINARY_DIR}${odb_cxx})add_custom_command(PRE_BUILDCOMMAND odbARGS -d mysql --std c++11 --generate-query --generate-schema --profile boost/date-time ${odb_path}/${odb_file}DEPENDS ${odb_path}/${odb_file}OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/${odb_cxx}COMMENT "生成ODB框架代码文件:" ${CMAKE_CURRENT_BINARY_DIR}/${odb_cxx})endif()
#   4. 将所有生成的框架源码文件名称保存起来 student-odb.cxx classes-odb.cxxlist(APPEND odb_srcs ${CMAKE_CURRENT_BINARY_DIR}/${odb_cxx})
endforeach()# 4. 获取源码目录下的所有源码文件
set(src_files "")
aux_source_directory(${CMAKE_CURRENT_SOURCE_DIR}/source src_files)
# 5. 声明目标及依赖
add_executable(main ${src_files} ${odb_srcs})
# 6. 设置头文件默认搜索路径
include_directories(${CMAKE_CURRENT_SOURCE_DIR}/entity)
include_directories(${CMAKE_CURRENT_BINARY_DIR})
# 7. 设置需要连接的库
target_link_libraries(main -lodb-mysql -lodb -lodb-boost -lgflags)#8. 设置安装路径
INSTALL(TARGETS main RUNTIME DESTINATION bin)

外层CMakeLists：

cmake_minimum_required(VERSION 3.1.3)
project(all-test)
add_subdirectory(${CMAKE_CURRENT_SOURCE_DIR}/test2)
set(CMAKE_INSTALL_PREFIX ${CMAKE_CURRENT_BINARY_DIR})

        测试结果结合mysql命令行客户端进行查看得知结果正确。

四.总结

        本篇文章是关于odb框架的安装与介绍，供大家和本人在日常开发中进行参考。

http://www.dtcms.com/a/290195.html

相关文章：

  • 部署zabbix企业级分布式监控
  • 智慧场景：定制开发开源AI智能名片S2B2C商城小程序赋能零售新体验
  • SLAM实战——13章代码学习及回环检测的补充
  • STM32-第九节-ADC模数转换
  • ❗量化模型构建回测框架
  • 【2025/07/21】GitHub 今日热门项目
  • 【HTTP缓存机制深度解析：从ETag到实践策略】
  • C# Lambdab表达式 Var 类
  • 如何防止QQ浏览器录屏，盗录视频资源？
  • Apache Ignite Binary Object 调优
  • 【牛客算法】小美的排列询问
  • Linux 命令大全
  • Java基础教程（010）：面向对象中的this和就近原则
  • 移星科技 modbus-tcp 转 modbus-Rtu模块
  • 安卓模拟器安装后，sdk版本详情简介及安卓sdk建议装哪几个版本
  • 突破量子仿真瓶颈：微算法科技MLGO量子算法的算术化与核操作迭代模型
  • 区块链之以太坊合约开发工具——Metamask钱包和Remix IDE
  • Android MTK平台预置多张静态壁纸
  • Freemarker生成Word文档下载到浏览器（下载word）
  • 上海GEO优化公司找哪家怎么做
  • uniapp底部导航栏凸起
  • windows电脑给iOS手机安装ipa包的方法
  • Kubernetes Pod调度基础
  • Leetcode力扣解题记录--第238题（前/后缀积）
  • 【Git#6】多人协作 企业级开发模型
  • 3D可视化模型轻量化陷阱：STL转GLTF的精度损失与压缩比平衡策略
  • 【系统全面】Linux内核原理——基础知识介绍
  • H3C路由器模拟PPPOE拨号
  • MTSC2025参会感悟：Multi-Agent RAG 应用质量保障建设
  • Java IO流体系详解：字节流、字符流与NIO/BIO对比及文件拷贝实践