micro_serve 1.0.5

A Flutter package initializes an HTTP server to handle HTTP requests.

Micro Serve

The micro_serve package for Flutter is designed to initialize an HTTP server that efficiently manages requests and server-side operations within applications.

Features

• HTTP Handling: Manage incoming HTTP requests and send responses.

• Routing: Define routes (GET, POST, PUT, DELETE, PATCH) and link them to request handlers.

• Request Parsing: Read and parse query parameters and body data from requests.

• Response Handling: Create and send responses with status codes, headers, and content.

• Error Handling: Gracefully manage errors and send appropriate error responses.

Getting started

Add the package to your pubspec.yaml file:

dependencies:
  micro_serve: <latest version>

Import the Package:

import 'package:micro_serve/micro_serve.dart';

Initialize the Server:

void main() {
  final MicroServe server = MicroServe();

  server.get("/hello", (ServerContext serverContext) async {
    final Response response = Response(
      statusCode: 200,
      data: "Welcome Micro-Serve",
    );
    serverContext.send(response);
  });

  server.listen(ipAddress: "127.0.0.1", port: 3000);
}

Usage

Create an Object of MicroServe:

final MicroServe _server = MicroServe();

Server On Function:

void _serverOn() async {
  //Define Routes
  _server.put('/update', _updateTask);

  //Get WiFi IP Address
  final String? lanWifiIp = await Network.getIp(NetworkType.wlan);
  const int port = 3000;

  // Server Start
  _server.listen(
    ipAddress: lanWifiIp,
    port: port,
    callBack: () {
      print("Server initiated");
    },
  );
}

Server Off Function:

void _serverOff() async {
  await _server.close();
}

Handler Function:

void _updateTask(ServerContext serverContext) {
  //Create an Object of Request() From ServerContext to Get Client Request
  final Request request = serverContext.request;

  final int Id = int.parse(request.queryParams["id"]);
  final Stirng name = jsonDecode(request.body)['name'];
  final String idDone = jsonDecode(request.body)['isDone'];

  //Create an Object of Response() to Send Client
  final Response response = Response();

  if (!_taskStore.containsKey(taskId)) {
    //Edit Response Object as Preference 1
    response.statusCode = HttpStatus.notFound_404.code;
    response.data = {"message": "not found"};
  } else {
    _taskStore[taskId]!.name = jsonDecode(request.body)['name'];
    _taskStore[taskId]!.isDone = jsonDecode(request.body)['isDone'];

    //Edit Response Object as Preference 2
    response.statusCode = HttpStatus.accepted_202.code;
    response.data = {"message": "updated successfully"};
  }

  //Send Response to Client
  serverContext.send(response);
}

API Reference

Method [PUT]:

http://ip:port/update?id=1

Body:

{
  "name" : "mh task",
  "isDone" : true
}

Limitation

Android	iOS	MacOS	Web	Linux	Windows
✅	✅	✅	❌	✅	✅
The functionality is not supported on Web.

Additional information

Micro Serve plugin is developed by Mahadi Hassan

[e-mail] | LinkedIn | GitHub | Website