패키지, 저장소 및 앱 카테고리 검색

패키지 상세v0.1.2

shelf_session

`shelf_session`은 `shelf`에 대한 `cookiesMiddleware` 및 `sessionMiddleware`의 구현입니다.

AndroidiOSmacOSWindowsLinux
30일 다운로드
22
좋아요
2
Pub 점수
160

패키지 설치

flutter pub add shelf_session

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

shelf_session 패키지는 Dart의 Shelf HTTP 서버 프레임워크를 위한 세션 관리 및 쿠키 처리 미들웨어를 제공합니다. 쿠키를 사용하여 세션 데이터를 저장하고 검색함으로써 상태 기반 상호작용을 가능하게 하여, Shelf로 구축된 웹 애플리케이션에서 사용자 세션을 더 쉽게 관리할 수 있도록 합니다. 이 패키지는 Shelf의 미들웨어 아키텍처와 원활하게 통합되며, 인증, 사용자 추적, 요청 간 지속 상태 유지에 대한 가벼운 솔루션을 제공합니다. 안전한 쿠키 설정을 지원하며, 단순한 서버 측 로직부터 복잡한 로직까지 모두 적합합니다.

사용 사례

  • Shelf 기반 서버에서 사용자 세션 관리
  • HTTP 요청 간 사용자 고유 데이터 저장
  • 인증 흐름 구현
  • 상태를 가진 웹 상호작용 처리
  • 세션 지원을 사용하여 REST API 구축하기

주요 기능

  • Shelf용 세션 미들웨어
  • 쿠키 기반 세션 저장
  • 보안 쿠키 구성
  • Shelf 미들웨어와의 간편한 통합
  • 세션 데이터의 직렬화를 지원합니다

적합한 대상

  • 서랍 기반 웹 서버
  • 상태 유지 웹 애플리케이션
  • 인증 시스템
  • 세션 관리를 필요로 하는 백엔드 서비스
  • Shelf 프레임워크를 사용하는 Dart 개발자

고려 사항

  • 올바른 쿠키 보안 설정이 필요합니다
  • 서버 측에 저장된 세션 데이터는 지속성 필요할 수 있음
  • 추가 조정 없이 고규모 분산 시스템에 적합하지 않습니다
  • 셰일프 생태계에 제한됨
  • 세션 만료 및 정리는 수동으로 관리해야 합니다

원본 README

연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.

shelf_session

The shelf_session is the implementation of cookiesMiddleware and sessionMiddleware for shelf.

Version: 0.1.0

About

Adds two middleware for shelf:

  • cookiesMiddleware
  • sessionMiddleware

The cookiesMiddleware can be used independently.
The sessionMiddleware depends on cookiesMiddleware and must be used after it.

final pipeline = const Pipeline()
    .addMiddleware(cookiesMiddleware())
    .addMiddleware(sessionMiddleware())
    .addHandler(handler);

A small workable example:

import 'dart:io' show Cookie;

import 'package:shelf/shelf.dart';
import 'package:shelf/shelf_io.dart' as io;
import 'package:shelf_router/shelf_router.dart';
import 'package:shelf_session/cookies_middleware.dart';
import 'package:shelf_session/session_middleware.dart';
import 'package:shelf_static/shelf_static.dart';

void main(List<String> args) async {
  final router = Router();
  router.get('/', _handleHome);
  router.get('/login', _handleLogin);
  router.get('/login/', _handleLogin);
  router.post('/login', _handleLogin);
  router.post('/login/', _handleLogin);
  router.get('/logout', _handleLogout);
  router.get('/logout/', _handleLogout);
  final staticHandler =
      createStaticHandler('web', defaultDocument: 'index.html');
  final handler = Cascade().add(staticHandler).add(router).handler;
  final pipeline = const Pipeline()
      .addMiddleware(logRequests())
      .addMiddleware(cookiesMiddleware())
      .addMiddleware(sessionMiddleware())
      .addHandler(handler);
  const address = 'localhost';
  const port = 8080;
  final server = await io.serve(pipeline, address, port);
  print('Serving at http://${server.address.host}:${server.port}');
}

const _menu = '''
<a href="/">Home</a><br />
<a href="/login">Log in</a><br />
<a href="/logout">Log out</a><br />''';

Future<Response> _handleHome(Request request) async {
  final userManager = UserManager();
  final user = userManager.getUser(request);
  var body = '$_menu{{message}}<br />{{cookies}}';
  if (user == null) {
    body = body.replaceAll('{{message}}', 'You are not logged in');
  } else {
    body = body.replaceAll('{{message}}', 'You are logged in as ${user.name}');
  }

  final cookies = request.getCookies();
  body = body.replaceAll('{{cookies}}',
      cookies.entries.map((e) => '${e.key}: ${e.value}').join('<br />'));
  request.addCookie(Cookie('foo', 'Foo'));
  if (!cookies.containsKey('baz')) {
    request.addCookie(Cookie('baz', 'Baz'));
  } else {
    request.removeCookie(Cookie('baz', ''));
  }

  return _render(body);
}

Future<Response> _handleLogin(Request request) async {
  const html = '''
<form action="" method="post">
<label>Login</label><br />
<input name="login" type="text" /><br />
<label>Password</label><br />
<input name="password" type="password" /><br /><br />
<button>Log in</button>
</form>
''';

  if (request.method == 'GET') {
    return _render(_menu + html);
  }

  final body = await request.readAsString();
  final queryParameters = Uri(query: body).queryParameters;
  final login = queryParameters['login'] ?? ''
    ..trim();
  final password = queryParameters['password'] ?? ''
    ..trim();
  if (login.isEmpty || password.isEmpty) {
    return _render(_menu + html);
  }

  final user = User(login);
  final userManager = UserManager();
  userManager.setUser(request, user);
  return Response.found('/');
}

Future<Response> _handleLogout(Request request) async {
  Session.deleteSession(request);
  return Response.found('/');
}

Response _render(String body) {
  return Response.ok(body, headers: {
    'Content-type': 'text/html; charset=UTF-8',
  });
}

class User {
  final String name;

  User(this.name);
}

class UserManager {
  User? getUser(Request request) {
    final session = Session.getSession(request);
    if (session == null) {
      return null;
    }

    final user = session.data['user'];
    if (user is User) {
      return user;
    }

    return null;
  }

  User setUser(Request request, User user) {
    var session = Session.getSession(request);
    session ??= Session.createSession(request);
    session.data['user'] = user;
    return user;
  }
}

Session data is stored in a hash map at runtime.
This implementation implies that session data should only be created for authorized users.
This approach eliminates memory overflow in the case of various types of attacks.
After the expiration of the lifetime, the session data is deleted automatically (which causes the memory to be freed).
Timers are not used for these purposes. This happens during the creation of new sessions.

카테고리

의존성

의존성 목록 1 개

소스 저장소

이 패키지를 사용하는 프로젝트

아직 데이터가 없습니다.