Elli เป็นเว็บเซิร์ฟเวอร์ที่คุณสามารถเรียกใช้ภายในแอปพลิเคชัน Erlang ของคุณเพื่อแสดง HTTP API มีวัตถุประสงค์เฉพาะเพื่อสร้าง HTTP API ที่มีปริมาณงานสูงและมีเวลาแฝงต่ำ หากความทนทานและประสิทธิภาพมีความสำคัญต่อคุณมากกว่าคุณสมบัติการใช้งานทั่วไป Elli ก็อาจใช่สำหรับคุณ หากคุณพบว่าตัวเองกำลังเจาะลึกการใช้งานเว็บเซิร์ฟเวอร์ Elli อาจใช่สำหรับคุณ หากคุณกำลังสร้างบริการทางเว็บ ไม่ใช่เว็บไซต์ Elli อาจใช่สำหรับคุณ
Elli ต้องใช้ OTP 22.0 หรือใหม่กว่า
เพิ่ม elli
ให้กับแอปพลิเคชันของคุณโดยขึ้นอยู่กับ rebar.config
ของคุณ:
{ deps , [
{ elli , " 3.3.0 " }
]}.
หลังจากนั้น ในการคอมไพล์ คุณสามารถรัน:
rebar3 compile
หากต้องการบูต Elli ภายในเชลล์ Erlang ให้รัน:
rebar3 shell
% % starting elli
1 > { ok , Pid } = elli : start_link ([{ callback , elli_example_callback }, { port , 3000 }]).
แหล่งที่ดีที่สุดในการเรียนรู้วิธีเขียนโมดูลการโทรกลับคือ elli_example_callback
นอกจากนี้ยังมีตัวอย่างจำนวนมากที่ใช้ในการทดสอบตลอดจนคำอธิบายของเหตุการณ์ทั้งหมด
โมดูลการโทรกลับขั้นต่ำมีลักษณะดังนี้:
- module ( elli_minimal_callback ).
- behaviour ( elli_handler ).
- include_lib ( " elli/include/elli.hrl " ).
- export ([ handle / 2 , handle_event / 3 ]).
handle ( Req , _Args ) ->
% % Delegate to our handler function
Method = Req # req . method ,
Path = elli_request : path ( Req ),
handle ( Method , Path , Req ).
handle ( 'GET' = _Method , [<< " hello " >>, << " world " >>] = _Path , _Req ) ->
% % Reply with a normal response. `ok' can be used instead of `200'
% % to signal success.
StatusCode = ok ,
Headers = [],
Body = << " Hello World! " >>,
{ StatusCode , Headers , Body };
handle ( _Method , _Path , _Req ) ->
{ 404 , [], << " Not Found " >>}.
% % @doc Handle request events: request completed, exception
% % thrown, client timeout, etc. Must return `ok'.
handle_event ( _Event , _Data , _Args ) ->
ok .
หากต้องการเพิ่ม elli
ให้กับหัวหน้างาน คุณสามารถใช้ตัวอย่างต่อไปนี้และปรับให้เข้ากับความต้องการของคุณได้
- module ( elli_minimal_sup ).
- behaviour ( supervisor ).
- export ([ start_link / 0 , init / 1 ]).
start_link () ->
SupName = { local , ? MODULE },
Module = ? MODULE ,
Args = [],
supervisor : start_link ( SupName , Module , Args ).
init ([] = _Args ) ->
ElliOpts = [
{ callback , elli_minimal_callback },
{ port , 3000 }
],
ElliSpec = {
_Id = elli_minimal_http ,
_Start = { elli , start_link , [ ElliOpts ]},
_Restart = permanent ,
_Shutdown = 5000 ,
_Worker = worker ,
_Modules = [ elli ]},
{ ok , {{ _Strategy = one_for_one , _Intensity = 5 , _Period = 10 }, [ ElliSpec ]} }.
สำหรับข้อมูลเพิ่มเติมเกี่ยวกับคุณสมบัติและปรัชญาการออกแบบของ Elli โปรดดู overview
Elli ได้รับอนุญาตภายใต้ใบอนุญาต MIT