Angel3 Developer Guide
  • README
  • Foreword
  • Tutorial
    • Getting Started
    • Minimal Setup
  • Command Line Interface
    • Setup
  • Templates and Views
    • Server Side Rendered Views
    • JAEL3
      • About
      • Basics
      • Custom Elements
      • Strict Resolution
      • Directive: declare
      • Directive: for-each
      • Directive: extend
      • Directive: if
      • Directive: include
      • Directive: switch
  • Authentication
    • About
    • Strategies
    • Local
  • Databases
    • Object Relational Mapping (ORM)
      • About
      • Basic Functionality
      • Relations
      • Migrations
      • PostgreSQL
    • NoSQL
  • Extensions and Plugins
    • Using Plug-ins
    • Writing a Plugin
  • Under the hood
    • Basic Routing
    • Requests & Responses
    • Request Lifecycle
    • Dependency Injection
    • Middleware
    • Controllers
    • Parsing Request Bodies
    • Serialization
    • Service Basics
    • Testing
    • Error Handling
    • Pattern Matching and Parameter
  • Angel Framework Migration
    • Angel 2.x.x to Angel3
      • Rationale - Why a new Version?
      • Framework Changelog
      • 3.0.0 Migration Guide
    • Angel 1.x.x to 2.x.x
      • Framework Changelog
      • 2.0.0 Migration Guide
  • Packages
    • Authentication
    • CORS
    • Database-Agnostic Relations
    • Configuration
    • Databases
      • ORM
      • MongoDB
      • JSON File-based
      • RethinkDB
    • Templates and Views
      • Jael template engine
      • Mustache Templates
      • compiled_mustache-based engine
      • html_builder-based engine
      • Markdown template engine
      • Using Angel with Angular
    • Hot Reloading
    • Pagination
    • Polling
    • Production Utilities
    • REST Client
    • Reverse Proxy
    • Router
    • Serialization
    • Service Seeder
    • Static Files
    • Security
    • Server-sent Events
    • shelf Integration
    • Task Engine
    • User Agents
    • Validation
    • Websockets
  • Resources
    • Dependency Injection Patterns
    • Example Projects
    • YouTube Tutorials
    • Ecosystem
Powered by GitBook
On this page
  • Main Points
  • Notes
  • What should I use instead of X?
  • How should I define global middleware?

Was this helpful?

  1. Angel Framework Migration
  2. Angel 1.x.x to 2.x.x

2.0.0 Migration Guide

PreviousAngel 1.x.x to 2.x.xNextPackages

Last updated 3 years ago

Was this helpful?

Based on .

Based on the changelog, up to 1.1.0:

Main Points

  • angel_diagnostics is deprecated - instead just pass a Logger and set it as app.logger.

  • Removed AngelFatalError, and subsequently fatalErrorStream.

    • Errors are automatically create 500. Set app.logger to see output.

    • angel_errors is no longer useful.

  • Removed all @deprecated members.

  • Removed @Hooked, beforeProcessed, and afterProcessed.

  • Made injections in RequestContext private.

  • Renamed properties in AngelBase to configuration.

  • Added support for pattern matching and other injections via @Parameter()

  • Officially deprecated properties in Angel.

  • Fixed a bug where cached routes would not heed the request method. #173

  • Reworked error handling logic; now, errors will not automatically default to sending JSON.

  • Removed the onController stream from Angel.

  • Controllers now longer use call, which has now been renamed to configureServer.

Notes

Aside from these points, there are several things to note.

Migration in itself will be pretty easy to achieve. Plugins and services haven't really changed, it's just the HTTP server itself.

What should I use instead of X?

In 1.1.0, the following were completely removed:

  • Angel.after,

  • Angel.before

  • Angel.justBeforeStart

  • Angel.justBeforeStop

  • Angel.fatalErrorStream

    • There is no replacement for before/after. This way, it is easier to keep track of the order request handlers run. responseFinalizers are still in place.

    • justBeforeStart, justBeforeStop => startupHooks, shutdownHooks

    • fatalErrorStream is no longer necessary; you can just set app.errorHandler. Fatal errors will be wrapped in a 500 response.

How should I define global middleware?

app.use((req, res) => ...)

Much cleaner in 1.1.0. 😄

this discussion
https://pub.dartlang.org/packages/angel_framework/versions/1.1.1#-changelog-tab-