Share My Creation [Project Template] [Web] API 2

Web API Template 2​

Version: 2.03

1683916091359-png.141987
1683827359648.png


Build REST API Server Using B4X Template
This is a very minimum template where you don't even need to connect to a database to work.
Optionally you can start with keyValueStore to persist the model. This will be a foundation to more complex Web API projects.

Depends on following libraries:
  • ByteConverter
  • jServer
  • Json
  • JavaObject
  • KeyValueStore

For older version, see webapi-b4j (v1.16) https://www.b4x.com/android/forum/threads/web-api-template.133764/

GitHub: https://github.com/pyhoon/webapi-2-b4j

Tutorials:
  1. Getting Started
  2. Download File Example
  3. Vue 3 CRUD Example
  4. Using Web API Controller
  5. Using MinimaList Controller
  6. Using #Plural tag

Features​

  • Redesign Architecture
    • The core handler - ApiHandler, acts like BaseController or Routes class
    • ApiHandler routes the RequestURI to controllers e.g /web/api/v2/data
    • HelpHandler (optional) generates API documentation for easy debugging without external tools or clients which embed tokens in request header. HelpHandler is now scanning through controllers class for APIs to list in the documentation instead of reading handlers from b4j project main module in version 1.x
    • Web and API paths can be changed in config.ini
    • Versioning can be enabled or disabled
    • Simple JSON response (Map or List)
    • Session can be toggled
    • Cookies can be toggled
    • Welcome message can be toggled
    • One stop ConfigServer sub to control all the settings
    • Default endpoint name is based on controller's name (e.g /web/api/v2/item for ItemController)
    • Overide endpoint name using #Plural (e.g /web/api/v2/items)
    • Custom version name using #Version (e.g v2, live, demo, dev, staging)
    • Description is set using #Desc (i.e no more using #Desc1, #Desc2 or Literals that was very confusing in version 1.x)
    • API endpoint can be hidden using #Hide
    • INTRODUCING: MinimaList -> store as Map/List. API server can run without database (or optionally persist as KeyValueStore).

Code Example​

B4X: 
Private Sub GetOneItem (id As Long)
    ' #Version = v2
    ' #Desc = Read one Item in MinimaList
    ' #Elements = [":id"]
    Dim M1 As Map = Main.MinimaItem.Find(id)
    HRM.ResponseCode = 200
    HRM.ResponseData.Initialize
    HRM.ResponseData.Add(M1)
    Utility.ReturnHttpResponse(HRM, Response)
End Sub


Special thanks to donors of this project:
  1. @yaqoob
  2. @Czampo

 

Attachments

  • Web API Server (2.03).b4xtemplate
    433.6 KB · Views: 121
Last edited:
Click to expand...
aeric

aeric

Expert
Licensed User
Longtime User
Web API Template 2 (MinimaList Edition) - NO Database Needed
version: 2.00
Uploaded in post #1 (only 261KB)

This is a very minimum template where you don't even need to connect to a database to work. Optionally you can start with keyValueStore to persist the model. This will be a foundation to more complex Web API projects.
 
Last edited:
aeric

aeric

Expert
Licensed User
Longtime User
Web API Template 2
version: 2.01
Uploaded in post #1 (only 260KB)

What's New?
  • Added: IndexController - routes to default home page (index.html template is also added)
  • Added: WebHandler - call IndexController
  • Added: CorsFilter
  • Improved: ApiHandler is now easier to use - A new RouteData sub can be use to route to other methods (e.g RouteDataGet and RouteDataPost)
  • Note: MinimaList data is now not persist using KeyValueStore by default. Meaning, data is reset when server is restarted. You can uncomment ConfigureKeyValueStore in ConfigureServer sub to persist the data.

1683916091359.png
 
byz

byz

Member
Licensed User
虽然还没有用你的webapi，但是一直有关注进度的。从帖子里给出的代码看，好像需要配置很多，不知道是否能够简单易用。
 
aeric

aeric

Expert
Licensed User
Longtime User
byz said:
虽然还没有用你的webapi，但是一直有关注进度的。从帖子里给出的代码看，好像需要配置很多，不知道是否能够简单易用。
Click to expand...
Please start a new thread in Chinese forum.
I will provide more examples and tutorials in the future.

请在中文论坛开一个新帖。
以后我会提供更多的例子和教程。
 
aeric

aeric

Expert
Licensed User
Longtime User
A tutorial is added.

[web]Web API Tutorial - Getting Started

Introduction: This tutorial is based on Web API Template 2. How to install: 1. Download the template and copy it to B4J Additional Library folder. 2. Open B4J and you will see the template when you select menu File->New. Getting Started 1. To quick start, just run the project in debug...
www.b4x.com www.b4x.com
 
aeric

aeric

Expert
Licensed User
Longtime User
Web API Template 2
version: 2.02
Uploaded in post #1 (432KB)

What's New?
  • Improved: ConfigureHandlers in Main module
  • Improved: More comments and integration guide in Main module
  • Improved: Removed unused global variables in Main module
  • Improved: Group unused Configurations in Main module
  • Improved: ApiHandler minor fixes
  • Improved: DataController minor fixes
  • Added: ReadConfig sub in Main module
  • Added: Shortcut link in AppStart by hovering mouse pointer to open the default page
  • Added: 2 fontawesome woff files to fix warnings in web dev tools (increases file size)
1684315402848.png
 
aeric

aeric

Expert
Licensed User
Longtime User
There is a bug in v2.02
Will update it soon Updated v2.02.1 in post #1

Note: DataController is now reading the item id instead of the list item index. This is easier to work with the vue app in Tutorial Example 2.

I need to add
B4X: 
Minima.Initialize
before
B4X: 
ConfigureServer
or else the object is not initialized.

B4X: 
Sub AppStart (Args() As String)
    srvr.Initialize("")       ' Create the server
    ReadConfig                ' Read environment settings
    Minima.Initialize         ' Initialize MinimaList
    ConfigureServer           ' Configure the server
    srvr.Start                ' Start the server
    StartMessageLoop
End Sub
 
Last edited:
aeric

aeric

Expert
Licensed User
Longtime User
Web API Controller (use with MinimaList and KeyValueStore)
version: 1.00
Attached in post #2 (2KB)

Deprecated: Check the new tutorial [Web API 2] Tutorial - Using Web API Controller

How to use:
  1. Unzip the jar and xml file to B4J Additional Library folder
  2. Find and check "WebAPIController" in B4J Libraries Manager
  3. Go to menu Project > Add New Module > Class Module and select "Web API Controller"
  4. Give a name e.g "UserController"
  5. A boilerplate controller is added with subs contains the word "Item"
  6. You can use Quick Search to rename the word "Item" to "User"

Working with MinimaList
  1. You need to create a new MinimaList object in Main module
  2. In Process_Globals sub of Main module, add the following line:
    B4X: 
    Public MinimaUser As MinimaList
  3. Inside AppStart sub, initialize the object
    B4X: 
    MinimaUser.Initialize
  4. In ConfigureControllers sub, add the controller so you can check with the API documentation
    B4X: 
    Public Sub ConfigureControllers
    Controllers.Initialize
    Controllers.Add("DataController")
    Controllers.Add("UserController")
End Sub
  5. Inside UserController class, using Quick Search tab, replace the word "Item" to "User", "Minima" to "MinimaUser"
  6. Go to ApiHandler, inside ProcessRequest sub, add a new route
    B4X: 
    Select ControllerElement
    Case "data"
        RouteData(ApiVersionElement, ControllerIndex, FirstIndex, SecondIndex)
        Return
    Case "user"
        RouteUser(ApiVersionElement, ControllerIndex, FirstIndex)
        Return
End Select
  7. You can clone the code for RouteData (and other related subs) to RouteUser
  8. You can use Quick search, highlight the copied code and replace the word "Data" to "User" using the "In Selection" button
  9. Adjust the parameter or delete SecondIndex if it is not used.
  10. Test the new API using the documentation page.
This is some work. Hopefully the steps are more simplified in the future.
 
Last edited:
aeric

aeric

Expert
Licensed User
Longtime User
Web API Template 2
version: 2.03
Uploaded in post #1 (434KB)

What's New?
  • Improved: ApiHandler is now more cleaner. All logic should put in controller class. ApiHandler will call the Route method without any parameter of the controller.
  • Changed: Sub ConfigureResponse is now disabled. JSON Response is now follow "standard" format by default, instead of "simple" format. You can still enable it.
B4X: 
Select ControllerElement
    Case "data"
        Dim Data As DataController
        Data.Initialize(Request, Response)
        Data.Route
        Return
    Case "item"
        Dim Item As ItemController
        Item.Initialize(Request, Response)
        Item.Route
        Return
End Select
 
Xfood

Xfood

Expert
Licensed User
aeric said:
I already answered in post #13.
I don't share the blog system as Web API Template 2.0 but will consider to publish as another product.
Click to expand...
always with the same logic you could create a support ticket system, to manage helpdesk calls, I would be willing to buy such a source, and I also believe many in this community would benefit from it
 
aeric

aeric

Expert
Licensed User
Longtime User
Xfood said:
always with the same logic you could create a support ticket system, to manage helpdesk calls, I would be willing to buy such a source, and I also believe many in this community would benefit from it
Click to expand...

Support Ticket System powered by Web API 2

What is your offer price and features you are looking for? Poll will be closed on Jun 23, 2023. Guys, thanks for voting.
www.b4x.com www.b4x.com
 
aeric

aeric

Expert
Licensed User
Longtime User
A new version of MinimaList is posted in code snippets

MinimaList

MinimaList Version : 0.07 a utility class to manage a simple collections of Map inside List Treat it as some kind of a NoSQL for key-value pair or KVS. It is suitable for small demo but I don't recommend it for serious project. Properties List (read/write) Map (read/write) First As Map (read)...
www.b4x.com www.b4x.com
 
aeric

aeric

Expert
Licensed User
Longtime User
Web API Template 2
version: 2.04 beta1
(443KB)
Note: This is still in beta version

What's New?
  • Support B4X Web API Client
  • Web Front-end with CRUD Demo
  • MinimaListController replaced WebAPIController

For Web API Client (1.05), modify the following line in B4XMainPage class:
B4X: 
'Private URL As String = "http://192.168.50.42:19800/v1/"
Private URL As String = "http://192.168.50.42:19800/web/api/v2/"
 

Attachments

  • Web API Server (2.04 beta1).b4xtemplate
    442.9 KB · Views: 15
aeric

aeric

Expert
Licensed User
Longtime User
Web API Template 2
version: 2.04 beta2
(442KB)
Note: This is still in beta version

What's New?
  • Support B4X Web API Client 1.05
  • Web Front-end with CRUD Demo
  • MinimaListController replaced WebAPIController
  • Changes in ConfigureServer subs order and ConfigurePort is enabled as default
  • Clean up unused code
  • Timezone removed
  • DataController has been removed
  • Methods inside MinimaList class are renamed
Seed dummy data by calling:
 

Attachments

  • Web API Server (2.04 beta2).b4xtemplate
    441.1 KB · Views: 13
aeric

aeric

Expert
Licensed User
Longtime User
Web API Template 2
version: 2.04 beta3
(435KB)
Note: This is still in beta version and for testing B4J 10.00 Snippets feature

What's New?
  • Support B4X Web API Client 1.05
  • Web Front-end with CRUD Demo
  • Changes in ConfigureServer subs order and ConfigurePort is enabled as default
  • Clean up unused code
  • Timezone removed
  • DataController has been removed
  • Methods inside MinimaList class are renamed
  • (new) WebApiUtils.b4xlib (with Code Snippets) replaces Utility and WebUtils modules
  • (new) MinimaListController (version 1.05) replaces WebAPIController
Edit: Check version 2.04 beta 4
 
Last edited:
You must log in or register to reply here.

Similar Threads

aeric
  • Article
Share My Creation [Project Template] [Web] API
4 5 6
Replies
109
Views
22K
aeric
aeric
Mashiane
Mashy Teaches WebApp/Website Development with BANanoVuetifyAD3 - The New Series
7 8 9
Replies
163
Views
34K
Mashiane
Mashiane
aeric
  • Article
Share My Creation [B4X] User Login App + [B4J] MySQL API Server (Key + Token)
2 3
Replies
42
Views
15K
pixet
pixet
aeric
  • Article
Share My Creation JQuiz - API Server for B4XQuiz
Replies
4
Views
3K
aeric
aeric
Erel
  • Locked
  • Article
B4J Tutorial [WebApp] Web Apps Overview
2 3 4
Replies
66
Views
107K
Erel
Erel
Top