ResourceHub API. Not for production. Replacement Rocket crate (library) to Actix (Actix web), added endpoints for get, get_by_id, create for first tests, later i will add database connection and impliment saving sensor data into Database.,

This commit is contained in:
SocioCyber
2026-04-14 09:20:19 -07:00
parent cb698814ee
commit 8fce4071a2
11 changed files with 703 additions and 1021 deletions

1398
ResourceHub/Cargo.lock generated

File diff suppressed because it is too large Load Diff

View File

@@ -6,7 +6,8 @@ edition = "2024"
[dependencies]
tokio = { version = "1.50.0", features = ["full"] }
redis = { version = "1.0.4", features = ["json"] }
rocket = { version = "0.5.1", features = ["json"] }
tinterm = "0.2.0"
serde = "1.0.228"
serde_json = "1.0.149"
serde_json = "1.0.149"
deadpool-redis = "0.23.0"
actix-web = "4.13.0"

View File

@@ -1,8 +1,14 @@
# ResourceHUB [API]
![Resource-hub-2](./images/Resource-hub-2-2.png)![SOFT](./images/SOFT.png)
## [API] Library
[ACTIX (actix-web)](https://actix.rs/docs/server)
> [!NOTE]
> **[DataCollector]** sends [**sensor's data] **like as *PH Level*, *Humidity*, *Temperature*, etc) as ++JSON++ to this **[API]**
> **RESOURCE HUB - means a Public Storage with Sensors Data,.**![Resource-hub-2](./images/Resource-hub-2-2.png)**
> **[DataCollector]** sends [**sensor's data] **like as *PH Level*, *Humidity*, *Temperature*, etc) as ++JSON++ to this [API]**
> **RESOURCE HUB - means a Public Storage with Sensors Data,.**
> ![image](./images/pasted_20260318-150812.png)
> ```json
> {
@@ -53,15 +59,14 @@
> - **S1** - Means: **Sector** **1**
> - **C1** - Means: **Cell** **1**
> - **:** - field splitter (for future. May be parsers can use this for getting fields: cityid, cords, sector, cell)
>
> ### In concept
> > SECTOR-5-CELL-1 can collect data about tomatos
> > SECTOR-5-CELL-2 can collect data about potatos
> > SECTOR-5-CELL-1 can collect data about tomatos
> > SECTOR-5-CELL-2 can collect data about potatos
> > **In future can be added 'resource' journals,.**
> > **a. "how much" system make a 'tomatos', 'gabbages,.' : 10 tomatos/month, 40 gabbeges/month, etc,.)**
> > **b. "n/year"**
> > **c. **
> ## * Sensors Data Table * [**Example**]
> ## Sensors Data Table [**Example**]
>
> | id | city_codename_cords_sector_cell | sensor_name_and_model | value | unit | timestamp |
> | --- | -------------------------------------------------------------------------------- | ---------------------------------------------------- | ----- | ------- | --------- |

BIN
ResourceHub/images/SOFT.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.6 MiB

View File

@@ -1,43 +1,70 @@
use rocket::serde::{json::Json};
use rocket::response::status;
use rocket::{get, post};
use actix_web::{get, post};
use actix_web::{Error, HttpResponse};
use actix_web::web::{Path, Json};
use crate::models::sensors::SensorData;
use crate::models::sensors::get_sensor_data;
use crate::models::sensors::get_sensor_data; // TODO - DELETE LATER, WHEN create data obj in Database WILL ADDED
use crate::repository::remote::redis;
// use crate::repository::remote::redis;
// use crate::repository::remote::sqlite;
// use crate::repository::remote::postgres;
// get data json obj
// database.getSensorData()
// send 200 http response with json obj
// 500
// create data json obj
// database.create(obj)
// send 200 http response
// 500
#[post("/sensors/data", format="json", data="<json>")]
pub async fn create(json: Json<SensorData>) -> status::Accepted<Json<SensorData>> {
let received_data = json.into_inner();
let data = get_sensor_data();
status::Accepted(Json(data))
// TODO - add json deserialization anwer to client, maybe
// saved_data = database.create(data);
// status::Accepted(Json(saved_data))
#[post("/sensors/data")]
pub async fn create(data: Json<SensorData>) -> HttpResponse {
let _received_data = data.into_inner();
// match let database.create(data) = true {
// Ok(HttpResponse::Ok().json(received_data))
// }
// return data to client
HttpResponse::Ok().json(200)
}
#[get("/sensors/data")]
pub async fn get() -> status::Accepted<Json<SensorData>> {
pub async fn get() -> Result<HttpResponse, Error> {
// get pool db
// let pool_db =
// get all data from DB
let data = get_sensor_data();
status::Accepted(Json(data))
// return data to client
Ok(HttpResponse::Ok().json(data))
}
#[get("/sensors/data/{id}")]
pub async fn get_by_id(id: Path<u32>) -> Result<HttpResponse, Error> {
println!("{}", id);
// Vulnirability: danger if ID in sql requsets
// get pool db
// let pool_db =
// get all data from DB
let data = get_sensor_data();
// return data to client
Ok(HttpResponse::Ok().json(data))
}
// Vulnirability: danger if ID in sql requsets !!!
// #[get("/sensors/data/<id>")]
// pub async fn get_by_id(id: u32) -> status::Accepted<Json<SensorData>> {
// // Vulnirability: danger if ID in sql requsets
// // http://127.0.0.1:8000/api/v1/sensors/data/?query=SELECT%20id%20FROM%20sensors
// // get data from DB

View File

@@ -3,49 +3,64 @@ mod endpoints;
mod models;
mod repository;
use rocket::{routes};
use actix_web::{HttpServer, App, web, middleware};
use util::constants;
use util::debug;
use repository::remote::redis;
// use repository::remote::redis;
#[rocket::main]
async fn main() -> Result<(), rocket::Error> {
#[actix_web::main]
async fn main() -> std::io::Result<()> {
util::colored_text::print_colored_text_brand("> SocioCybereeng ");
util::colored_text::print_colored_text_project("> Project: Hydroponic Systems ");
util::colored_text::print_colored_text_info("- [Welcome to ResourceHUB API] ");
if util::constants::IS_DEBUG == true {
debug::print_debug_info();
}
// Get database pool
// let pool = redis::get_pool(constants::DB_URI).await;
// Attempt to connect to DB and check the result
// Ok(conection) => {
// If the connection is successful, store it or use it as needed
// let mut _db = conection;
// }
// Start server
let _rocket = rocket::build()
.mount(format!("/api/v{}/", constants::API_VERSION), routes![
endpoints::sensors::data::create,
endpoints::sensors::data::get,
// endpoints::sensors::data::get_by_id,
])
.launch()
.await?;
Ok(())
// },
// Err(err) => {
// // Handle connection error and stop execution
// std::process::exit(1);
// }
// }
}
util::colored_text::print_colored_text_info(
&format!("Starting HTTP server at http://{}:{}/api/v1/",
constants::SERVER_URL, constants::SERVER_PORT));
HttpServer::new(|| {
App::new()
// enable logger - always register Actix Web Logger middleware last
.wrap(middleware::Logger::default().log_target("@"))
.service(
web::scope( &format!("/api/v{}", constants::API_VERSION) )
.service(endpoints::sensors::data::get)
.service(endpoints::sensors::data::get_by_id)
.service(endpoints::sensors::data::create)
)
// Service /api/v2
// Service /api/v3
// Service /api/v4
// ...
})
.bind((constants::SERVER_URL, constants::SERVER_PORT))?
.run()
.await
}
// TODO - ADD TLS (HTTPS)
// .bind_rustls_0_23(("127.0.0.1", 443), config)? // HTTPS port
// https://github.com/actix/examples/blob/main/middleware/http-to-https/src/main.rs
// TODO - ADD CORS
// https://actix.rs/docs/cors
// // Get database pool
// // let pool = redis::get_pool(constants::DB_URI).await;
// // Attempt to connect to DB and check the result
// // Start server
// endpoints::sensors::data::create,
// endpoints::sensors::data::get,
// // endpoints::sensors::data::get_by_id,

View File

@@ -1,5 +1,5 @@
use rocket::serde::{Deserialize, Serialize};
// use rocket::serde::{Deserialize, Serialize};
// #[derive(Deserialize, Serialize)]
// #[serde(crate = "rocket::serde")]
@@ -11,8 +11,9 @@ use rocket::serde::{Deserialize, Serialize};
// pub unit: String,
// }
use serde::{Deserialize, Serialize};
#[derive(Deserialize, Serialize)]
#[serde(crate = "rocket::serde")]
#[derive(Debug)]
pub struct SensorData {
pub id: Option<u32>,

View File

@@ -1 +1 @@
sqlite
// sqlite

View File

@@ -1,17 +1,63 @@
// use tokio::sync::{OnceCell, Mutex};
// use redis::{Connection, ConnectionLike, JsonCommands, RedisResult};
// use rocket::serde::{Deserialize, Serialize};
// // use tokio::sync::{OnceCell, Mutex};
// // use redis::{Connection, ConnectionLike, JsonCommands, RedisResult};
// // use rocket::serde::{Deserialize, Serialize};
// static DB_POOL: OnceCell<redis::Client> = OnceCell::const_new();
// // static DB_POOL: OnceCell<redis::Client> = OnceCell::const_new();
// // static DB_CONNECTOR: OnceCell<Mutex<Connection>> = OnceCell::const_new();
// // pub async fn get_pool(URI: &str) -> &'static redis::Client {
// // DB_POOL.get_or_init(|| async {
// // redis::Client::open(URI).expect("[ERR] Can't connect to database.")
// // }).await
// // }
// // // Asynccompatible accessor
// // pub async fn get_conn() -> tokio::sync::MutexGuard<'static, Connection> {
// // DB_CONNECTOR
// // .get()
// // .expect("Redis not initialised")
// // .lock()
// // .await
// // }
// // pub async fn get_data<T>(key: &str, con: &mut Connection) -> RedisResult<(T)>
// // where T: Deserialize<'static> {
// // let raw_data: String = con.json_get(&key, ".")?;
// // Ok( serde_json::from_str(&raw_data)? )
// // }
// // pub async fn set_data<T>(key: &str, data: &T, con: &mut Connection) -> RedisResult<()>
// // where T: Serialize,
// // {
// // Ok( con.json_set(&key, "$", &data)? )
// // }
// use tokio::sync::OnceCell;
// use tokio::sync::Mutex;
// use redis::{Client, Connection};
// // TODO - REPLACE REDIS POOL to deadpool_redis
// // https://docs.rs/deadpool-redis/latest/deadpool_redis/
// static DB_POOL: OnceCell<Client> = OnceCell::const_new();
// static DB_CONNECTOR: OnceCell<Mutex<Connection>> = OnceCell::const_new();
// pub async fn get_pool(URI: &str) -> &'static redis::Client {
// DB_POOL.get_or_init(|| async {
// redis::Client::open(URI).expect("[ERR] Can't connect to database.")
// }).await
// }
// pub async fn get_pool(uri: &str) -> redis::RedisResult<()> {
// let client = Client::open(uri)?;
// DB_POOL.set(client).ok();
// let conn = DB_POOL
// .get()
// .unwrap()
// .get_connection()
// ?;
// DB_CONNECTOR.set(Mutex::new(conn)).ok();
// Ok(())
// }
// // Asynccompatible accessor
// pub async fn get_conn() -> tokio::sync::MutexGuard<'static, Connection> {
@@ -22,64 +68,31 @@
// .await
// }
// // TODO TOKIIO AND MUTEX
// pub async fn get_data<T>(key: &str, con: &mut Connection) -> RedisResult<(T)>
// where T: Deserialize<'static> {
// let raw_data: String = con.json_get(&key, ".")?;
// Ok( serde_json::from_str(&raw_data)? )
// // async fn test<RV>() -> RedisResult<()> {
// // let _pool = redis::get_pool(constants::DB_URI).await;
// // let mut con = redis::get_conn();
// // let data1 = SensorData {
// // id: Some(1),
// // city_codename_cords_sector_cell: String::from("CERCELL:[40.7128,-74.0060]::S1:C1"),
// // sensor_name_and_model: String::from("Humidity:[DHT22]"),
// // value: 20.7,
// // unit: String::from("RH"),
// // timestamp: 17000002
// // };
// // con.son_set::<&str, &str, SensorData, RV>("asd", "$", &data1);
// // Ok(())
// // }
// use deadpool_redis::Pool;
// pub async fn get_pool(URL: &str) -> Result<bool, ()> {
// let mut config = Config::from_url(URL).unwrap();
// Ok( config.create_pool(Some(Runtime::Tokio1)).unwrap() )
// }
// pub async fn set_data<T>(key: &str, data: &T, con: &mut Connection) -> RedisResult<()>
// where T: Serialize,
// {
// Ok( con.json_set(&key, "$", &data)? )
// }
use tokio::sync::OnceCell;
use tokio::sync::Mutex;
use redis::{Client, Connection};
static DB_POOL: OnceCell<Client> = OnceCell::const_new();
static DB_CONNECTOR: OnceCell<Mutex<Connection>> = OnceCell::const_new();
pub async fn get_pool(uri: &str) -> redis::RedisResult<()> {
let client = Client::open(uri)?;
DB_POOL.set(client).ok();
let conn = DB_POOL
.get()
.unwrap()
.get_connection()
?;
DB_CONNECTOR.set(Mutex::new(conn)).ok();
Ok(())
}
// Asynccompatible accessor
pub async fn get_conn() -> tokio::sync::MutexGuard<'static, Connection> {
DB_CONNECTOR
.get()
.expect("Redis not initialised")
.lock()
.await
}
// TODO TOKIIO AND MUTEX
// async fn test<RV>() -> RedisResult<()> {
// let _pool = redis::get_pool(constants::DB_URI).await;
// let mut con = redis::get_conn();
// let data1 = SensorData {
// id: Some(1),
// city_codename_cords_sector_cell: String::from("CERCELL:[40.7128,-74.0060]::S1:C1"),
// sensor_name_and_model: String::from("Humidity:[DHT22]"),
// value: 20.7,
// unit: String::from("RH"),
// timestamp: 17000002
// };
// con.son_set::<&str, &str, SensorData, RV>("asd", "$", &data1);
// Ok(())
// }

View File

@@ -1,4 +1,7 @@
pub const SERVER_URL: &str = "127.0.0.1";
pub const SERVER_PORT: u16 = 3000;
pub const IS_DEBUG: bool = true; // set to 'false' in production!
pub const API_LIB: &str = "Actix";
pub const API_VERSION: &str = "1";
pub const DB_NAME: &str = "Redis";
pub const DB_URI: &str = "redis://:fswerfds@127.0.0.1:7878/";

View File

@@ -3,6 +3,7 @@ use crate::util::colored_text::*;
pub fn print_debug_info() {
print_colored_text_info(&format!("- SERVER INFO:"));
print_colored_text_info(&format!(" - API LIB: {} ", constants::API_LIB));
print_colored_text_info(&format!(" - API VERSION: {} ", constants::API_VERSION));
print_colored_text_info(&format!(" - DB NAME: {} ", constants::DB_NAME));
}