Angel
1.x
1.x
  • Introduction
  • Example Projects
  • Awesome Angel
  • 1.1.0 Migration Guide
  • Social
    • Angel on Gitter
    • Angel on Medium
    • Angel on YouTube
  • The Basics
    • Installation & Setup
      • Without the Boilerplate
    • Requests & Responses
    • Dependency Injection
    • Basic Routing
    • Request Lifecycle
    • Middleware
    • Controllers
    • Handling File Uploads
    • Using Plug-ins
    • Rendering Views
    • REST Client
    • Testing
    • Error Handling
    • Pattern Matching and Parameter
    • Command Line
  • Flutter
    • Writing a Chat App
    • Flutter helper widgets
  • Services
    • Service Basics
    • TypedService
    • In-Memory
    • Custom Services
    • Hooks
      • Bundled Hooks
    • Database-Agnostic Relations
    • Database Adapters
      • MongoDB
      • RethinkDB
      • JSON File-based
  • Plug-ins
    • Authentication
    • Configuration
    • Diagnostics & Logging
    • Reverse Proxy
    • Service Seeder
    • Static Files
    • Validation
    • Websockets
    • Server-sent Events
    • Toggle-able Services
  • Middleware/Finalizers
    • CORS
    • Response Compression
    • Security
    • File Upload Security
    • shelf Integration
    • User Agents
    • Pagination
    • Range, If-Range, Accept-Ranges support
  • PostgreSQL ORM
    • Model Serialization
    • Query Builder + ORM
    • Migrations
  • Deployment
    • Running in Isolates
    • Configuring SSL
    • HTTP/2 Support
    • Ubuntu and nginx
    • AppEngine
    • Production Mode
  • Front-end
    • Mustache Templates
    • Jael template engine
      • Github
      • Basics
      • Custom Elements
      • Strict Resolution
      • Directive: declare
      • Directive: for-each
      • Directive: extend
      • Directive: if
      • Directive: include
      • Directive: switch
    • compiled_mustache-based engine
    • html_builder-based engine
    • Markdown template engine
    • Using Angel with Angular
  • Advanced
    • API Documentation
    • Contribute to Angel
    • Scaling & Load Balancing
    • Standalone Router
    • Writing a Plugin
    • Task Engine
    • Hot Reloading
    • Real-time polling
Powered by GitBook
On this page
  • Main Points
  • Notes
  • What should I use instead of X?
  • How should I define global middleware?

1.1.0 Migration Guide

PreviousIntroductionNextSocial

Last updated 6 years ago

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-