first commit

This commit is contained in:
bing
2026-04-03 11:32:07 +08:00
commit 003be19522
1142 changed files with 185854 additions and 0 deletions

View File

@@ -0,0 +1,446 @@
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<title>QxOrm HTTP Server - qxBlogRestApi project</title>
<script type="text/javascript" src="jquery.js"></script>
</head>
<body>
<h1>Welcome to QxOrm HTTP Server - qxBlogRestApi example project</h1>
<table>
<tbody>
<tr>
<td align="center" style="padding-right: 15px; background-color: #e6f9ff;">
<label><b><font color="blue">JSON request</font></b></label>
</td>
<td align="center" style="padding-right: 15px; background-color: #e6f9ff;">
<label style="background-color: #e6f9ff;"><b><font color="blue">JSON response</font></b></label>
</td>
</tr>
<tr>
<td valign="top" style="padding-right: 15px">
<textarea id="txtRequest" rows="10" cols="80" wrap="off" style="width: 100%; background-color: #f9f9fb;"></textarea>
</td>
<td rowspan="3" valign="top">
<textarea id="txtResponse" rows="35" cols="80" wrap="off" style="width: 100%; background-color: #f9f9fb;"></textarea>
<br/><br/><a href="https://www.qxorm.com/" target="_blank"><img src="logo_qxorm_and_qxee.png" alt="QxOrm, QxEntityEditor"></a>
</td>
</tr>
<tr>
<td style="padding-right: 15px">
<input id="btnSendRequest" type="button" value="Send JSON request" style="width: 100%; height: 40px; color: blue; font-weight: bold; font-size: 16px;">
</td>
</tr>
<tr>
<td style="padding-right: 15px">
<br/><label><i><font color="blue">Here are some request examples :</font></i></label><br/>
<select id="lstRequestExample" size="25" style="width: 100%;">
<option id="get_meta_data"> - get project meta-data (all classes)</option>
<option id="fetch_all_blogs"> - fetch all blogs (as list)</option>
<option id="fetch_all_blogs_as_collection"> - fetch all blogs (as collection key/value)</option>
<option id="fetch_all_blogs_with_relationships"> - fetch all blogs with relationships (several levels)</option>
<option id="fetch_all_blogs_with_relationships_output_format"> - fetch all blogs with relationships (several levels) and define output format</option>
<option id="fetch_blog_by_id"> - fetch a single blog by id</option>
<option id="fetch_blog_by_id_columns"> - fetch some columns of a single blog by id</option>
<option id="fetch_list_of_blog_by_id"> - fetch list of blogs by id</option>
<option id="fetch_list_of_blog_by_id_output_format"> - fetch list of blogs by id and define output format</option>
<option id="fetch_authors_by_query"> - fetch authors using a query (only female)</option>
<option id="fetch_authors_by_query_with_relationships"> - fetch authors with relationships using a query</option>
<option id="fetch_authors_by_query_with_relationships_output_format"> - fetch authors with relationships using a query and define output format</option>
<option id="insert_blog"> - insert a blog</option>
<option id="insert_list_of_blog"> - insert list of blogs</option>
<option id="insert_author"> - insert an author</option>
<option id="insert_category"> - insert a category</option>
<option id="update_blog"> - update a blog</option>
<option id="update_blog_columns"> - update some columns of blog</option>
<option id="update_author"> - update an author</option>
<option id="update_list_of_author"> - update list of authors</option>
<option id="update_category"> - update a category</option>
<option id="save_blog"> - save (insert or update) a blog</option>
<option id="save_list_of_blog"> - save (insert or update) list of blogs</option>
<option id="save_blog_recursive"> - save (insert or update) a blog with relationships (recursively)</option>
<option id="save_blog_recursive_insert"> - save (insert optimized) a blog with relationships (recursively)</option>
<option id="exist_blog"> - check if a blog id exist</option>
<option id="exist_list_of_blog"> - check if list of blogs id exist</option>
<option id="exist_author"> - check if an author id exist</option>
<option id="validate_blog"> - validate a blog instance</option>
<option id="count_all_blog"> - count all blogs</option>
<option id="count_author_with_query"> - count authors using a query</option>
<option id="count_blog_with_query_and_relationships"> - count blogs using a query and relationships</option>
<option id="delete_blog_by_id"> - delete a blog by id</option>
<option id="delete_list_of_blog_by_id"> - delete list of blogs by id</option>
<option id="delete_author_by_query"> - delete some authors using a query</option>
<option id="delete_all_comment"> - delete all comments</option>
<option id="call_custom_query"> - call custom database query or stored procedure</option>
<option id="call_entity_function"> - call entity static function with signature : static QJsonValue myEntity::myFct(const QJsonValue & request)</option>
<option id="several_requests_in_array"> - build several requests in array to send only 1 call to server (executed in a transaction commit/rollback)</option>
</select>
</td>
</tr>
</tbody>
</table>
<script>
$(document).ready(function() {
$("#lstRequestExample").change(function() {
var id = $(this).children(":selected").attr("id");
var request = buildRequestExample(id);
$("#txtRequest").val(JSON.stringify(request, null, 3));
$("#txtResponse").val("");
});
$("#btnSendRequest").click(function() {
sendRequest($("#txtRequest").val());
});
$('select option:even').css({'background-color': '#e6ffe6'});
$('#lstRequestExample option[id="get_meta_data"]').prop("selected", true);
var request = buildRequestExample("get_meta_data");
$("#txtRequest").val(JSON.stringify(request, null, 3));
$("#txtResponse").val("");
});
function sendRequest(request) {
$.post("/qx", request, function(data, status, xhr) {
$("#txtResponse").val(JSON.stringify(data, null, 3));
}, "json").fail(function(error) {
alert("An error occurred sending request to QxOrm HTTP server : " + error);
});
}
function buildRequestExample(id) {
var request = { };
request.request_id = createGUID();
if (id == "get_meta_data") {
request.action = "get_meta_data";
request.entity = "*";
}
else if (id == "fetch_all_blogs") {
request.action = "fetch_all";
request.entity = "blog";
}
else if (id == "fetch_all_blogs_as_collection") {
request.action = "fetch_all";
request.entity = "blog";
request.data = [ { key: "", value: "" } ]
}
else if (id == "fetch_all_blogs_with_relationships") {
request.action = "fetch_all";
request.entity = "blog";
request.relations = [ "*->*" ];
}
else if (id == "fetch_all_blogs_with_relationships_output_format") {
request.action = "fetch_all";
request.entity = "blog";
request.relations = [ "<blog_alias> { blog_text }", "author_id <author_alias> { name, birthdate }", "list_comment <list_comment_alias> { comment_text } -> blog_id <blog_alias_2> -> * <..._my_alias_suffix>" ];
request.output_format = [ "{ blog_text }", "author_id { name, birthdate }", "list_comment { comment_text } -> blog_id -> *" ];
}
else if (id == "fetch_blog_by_id") {
request.action = "fetch_by_id";
request.entity = "blog";
request.data = { blog_id: 1 };
}
else if (id == "fetch_blog_by_id_columns") {
request.action = "fetch_by_id";
request.entity = "blog";
request.data = { blog_id: 1 };
request.columns = [ "blog_text", "date_creation" ];
}
else if (id == "fetch_list_of_blog_by_id") {
request.action = "fetch_by_id";
request.entity = "blog";
request.data = [ { blog_id: 1 }, { blog_id: 2 }, { blog_id: 3 } ];
}
else if (id == "fetch_list_of_blog_by_id_output_format") {
request.action = "fetch_by_id";
request.entity = "blog";
request.data = [ { blog_id: 1 }, { blog_id: 2 } ];
request.relations = [ "{ blog_text }", "author_id <author_alias> { name, birthdate }", "list_comment <list_comment_alias> { comment_text }" ];
request.output_format = [ "{ blog_text }", "author_id { name, birthdate }", "list_comment { comment_text }" ];
}
else if (id == "fetch_authors_by_query") {
request.action = "fetch_by_query";
request.entity = "author";
request.query = {
sql: "WHERE author.sex = :sex",
params: [ { key: ":sex", value: 1, type: "in" } ]
};
}
else if (id == "fetch_authors_by_query_with_relationships") {
request.action = "fetch_by_query";
request.entity = "author";
request.query = {
sql: "WHERE author.sex = :sex",
params: [ { key: ":sex", value: 1, type: "in" } ]
};
request.relations = [ "*" ];
}
else if (id == "fetch_authors_by_query_with_relationships_output_format") {
request.action = "fetch_by_query";
request.entity = "author";
request.query = {
sql: "WHERE author.sex = :sex",
params: [ { key: ":sex", value: 1, type: "in" } ]
};
request.relations = [ "*" ];
request.output_format = [ "{ birthdate, name }", "list_blog { blog_text, date_creation }" ];
}
else if (id == "insert_blog") {
request.action = "insert";
request.entity = "blog";
request.data = {
blog_text: "this is a new blog from QxOrm REST API !",
date_creation: "2018-01-30T12:42:01",
author_id: "author_id_2"
};
}
else if (id == "insert_list_of_blog") {
request.action = "insert";
request.entity = "blog";
request.data = [
{
blog_text: "new blog from QxOrm REST API !",
date_creation: "2018-01-30T12:42:01",
author_id: "author_id_2"
},
{
blog_text: "another blog from QxOrm REST API !",
date_creation: "2016-06-12T08:33:12",
author_id: "author_id_1"
}
];
}
else if (id == "insert_author") {
request.action = "insert";
request.entity = "author";
request.data = {
author_id: "author_id_from_rest_api",
birthdate: "1978-05-11",
name: "new author created by QxOrm REST API",
sex: 1
};
}
else if (id == "insert_category") {
request.action = "insert";
request.entity = "category";
request.data = {
description: "category from REST API",
name: "new_category"
};
}
else if (id == "update_blog") {
request.action = "update";
request.entity = "blog";
request.data = {
blog_id: 1,
blog_text: "modify blog from QxOrm REST API",
date_creation: "2013-11-25T09:56:33",
author_id: "author_id_1"
};
}
else if (id == "update_blog_columns") {
request.action = "update";
request.entity = "blog";
request.data = {
blog_id: 2,
blog_text: "modify blog from QxOrm REST API",
date_creation: "2013-11-25T09:56:33"
};
request.columns = [ "blog_text", "date_creation" ];
}
else if (id == "update_author") {
request.action = "update";
request.entity = "author";
request.data = {
author_id: "author_id_from_rest_api",
birthdate: "1992-11-03",
name: "modify author from QxOrm REST API",
sex: 0
};
}
else if (id == "update_list_of_author") {
request.action = "update";
request.entity = "author";
request.data = [
{
author_id: "author_id_from_rest_api",
birthdate: "1992-11-03",
name: "modify author from QxOrm REST API",
sex: 0
},
{
author_id: "author_id_1",
birthdate: "1978-12-25",
name: "modify another author from QxOrm REST API",
sex: 2
}
];
}
else if (id == "update_category") {
request.action = "update";
request.entity = "category";
request.data = {
category_id: 1,
description: "category modified by REST API",
name: "modif_category"
};
}
else if (id == "save_blog") {
request.action = "save";
request.entity = "blog";
request.data = {
blog_id: 1,
blog_text: "modify blog from QxOrm REST API",
date_creation: "2013-11-25T09:56:33",
author_id: "author_id_1"
};
}
else if (id == "save_list_of_blog") {
request.action = "save";
request.entity = "blog";
request.data = [
{
blog_id: 1,
blog_text: "save blog from QxOrm REST API !",
date_creation: "2018-01-30T12:42:01",
author_id: "author_id_2"
},
{
blog_text: "save another blog from QxOrm REST API !",
date_creation: "2016-06-12T08:33:12",
author_id: "author_id_1"
}
];
}
else if (id == "save_blog_recursive") {
request.action = "save";
request.entity = "blog";
request.data = {
blog_id: 1,
blog_text: "save recursive blog from QxOrm REST API",
date_creation: "2013-11-25T09:56:33",
author_id: {
author_id: "author_id_1",
birthdate: "1965-07-21",
name: "save recursive author from QxOrm REST API",
sex: 0
}
};
request.save_mode = "check_insert_or_update";
}
else if (id == "save_blog_recursive_insert") {
request.action = "save";
request.entity = "blog";
request.data = {
blog_text: "save recursive - new blog from QxOrm REST API",
date_creation: "2013-11-25T09:56:33",
author_id: {
author_id: "author_id_save_recursive",
birthdate: "1965-07-21",
name: "save recursive (insert only) author from QxOrm REST API",
sex: 0
}
};
request.save_mode = "insert_only";
}
else if (id == "exist_blog") {
request.action = "exist";
request.entity = "blog";
request.data = { blog_id: 1 };
}
else if (id == "exist_list_of_blog") {
request.action = "exist";
request.entity = "blog";
request.data = [ { blog_id: 1 }, { blog_id: 999 }, { blog_id: 3 } ];
}
else if (id == "exist_author") {
request.action = "exist";
request.entity = "author";
request.data = { author_id: "author_id_2" };
}
else if (id == "validate_blog") {
request.action = "validate";
request.entity = "blog";
request.data = { blog_id: 9999, blog_text: "" };
}
else if (id == "count_all_blog") {
request.action = "count";
request.entity = "blog";
}
else if (id == "count_author_with_query") {
request.action = "count";
request.entity = "author";
request.query = {
sql: "WHERE author.sex = :sex",
params: [ { key: ":sex", value: 1 } ]
};
}
else if (id == "count_blog_with_query_and_relationships") {
request.action = "count";
request.entity = "blog";
request.query = {
sql: "WHERE author_alias.sex = :sex",
params: [ { key: ":sex", value: 1 } ]
};
request.relations = [ "author_id <author_alias> { sex }" ];
}
else if (id == "delete_blog_by_id") {
request.action = "delete_by_id";
request.entity = "blog";
request.data = { blog_id: 4 };
}
else if (id == "delete_list_of_blog_by_id") {
request.action = "delete_by_id";
request.entity = "blog";
request.data = [ { blog_id: 3 }, { blog_id: 2 } ];
}
else if (id == "delete_author_by_query") {
request.action = "delete_by_query";
request.entity = "author";
request.query = {
sql: "WHERE author.sex = :sex",
params: [ { key: ":sex", value: 1 } ]
};
}
else if (id == "delete_all_comment") {
request.action = "delete_all";
request.entity = "comment";
}
else if (id == "call_custom_query") {
request.action = "call_custom_query";
request.query = {
sql: "INSERT INTO author (author_id, name, birthdate, sex) VALUES (:author_id, :name, :birthdate, :sex)",
params: [
{ key: ":author_id", value: "author_id_custom_query" },
{ key: ":name", value: "new author inserted by custom query" },
{ key: ":birthdate", value: "20190215" },
{ key: ":sex", value: 2 }
]
};
}
else if (id == "call_entity_function") {
request.action = "call_entity_function";
request.entity = "blog";
request.fct = "helloWorld";
request.data = { param1: "test", param2: "static fct call" };
}
else if (id == "several_requests_in_array") {
request = [ buildRequestExample("get_meta_data"),
buildRequestExample("fetch_all_blogs"),
buildRequestExample("exist_blog"),
buildRequestExample("call_entity_function") ];
}
else {
request.error = "<unknown request example : " + id + ">";
}
return request;
}
function createGUID() {
return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, function(c) {
var r = Math.random() * 16 | 0, v = c == "x" ? r : (r & 0x3 | 0x8);
return v.toString(16);
});
}
</script>
</body>
</html>