mgonto/restangular
Restangular
Restangular is a REST client and resource mapper for AngularJS applications. It provides a suite of tools for mapping API endpoints to local objects and collections, facilitating frontend CRUD implementation through standard HTTP methods.
The project distinguishes itself through an async data binding system that links user interface elements to server-side objects, ensuring automatic updates upon request completion. It also features a programmable request interceptor pipeline for modifying headers and transforming responses, as well as a JSONP request handler to bypass same-origin policy restrictions.
Broad capabilities include the management of nested resources, self-referencing link resolution for HATEOAS support, and the ability to extend resource models using transformers. The system also supports multipart file uploads, response caching, and the configuration of scoped service instances with global defaults.
Features
- AngularJS API Integration - Acts as a dedicated REST client and resource mapper specifically for AngularJS applications.
- REST APIs - Provides a comprehensive client for executing standard HTTP methods including GET, POST, PUT, and DELETE against REST API resources.
- Remote Entity CRUD - Facilitates the execution of create, read, update, and delete operations against a backend API to manage application state.
- Resource Mappings - Translates remote API data structures into typed local JavaScript objects that mirror server-side data.
- REST API Integration Frameworks - Maps API endpoints to local JavaScript objects and collections using standard HTTP operations.
- Asynchronous - Links user interface elements to server-side data objects that update automatically upon request completion.
- HTTP Request Interceptors - Provides a programmable pipeline to modify outgoing headers and query parameters before requests are transmitted.
- Request Interceptors - Implements a programmable chain of handlers to centralize header modification and error logic for all network requests.
- API Response Processing - Transforms raw server responses globally to process wrapped data before it reaches application logic.
- REST Resource Mapping - Connects API endpoints to local objects and collections using standard HTTP methods for efficient resource management.
- RESTful API Clients - Implements a comprehensive client for interacting with RESTful web services and managing resources.
- Template Data Binding - Connects server responses to UI elements using reference objects that update automatically.
- Resource - Provides transformers that augment server data objects with custom methods and functions to enhance the data structure before it reaches the UI.
- Global Defaults - Allows defining universal base URLs, default headers, and query parameters for every outgoing network call.
- API Error Handling Patterns - Provides a centralized interceptor to capture all request failures for global debugging and security logic.
- Error Interception Handlers - Implements handlers that capture failed requests to execute global error logic or token refresh workflows.
- HATEOAS Link Resolution - Prioritizes server-provided self-referencing links over local templates to support HATEOAS-compliant resource resolution.
- HATEOAS Resource Resolution - Supports HATEOAS by prioritizing server-provided self-referencing links for URL resolution.
- Nested Resource Chaining - Simplifies the management of hierarchical API paths by chaining resource requests without manual URL construction.
- Resource Path Chaining - Handles hierarchical API paths by linking parent and child resource requests to automate complex URL construction.
- Scoped Service Instances - Allows the creation of isolated service instances that inherit global defaults with domain-specific overrides.
- Asynchronous Data Caching - Links UI elements to data objects before a server request completes to ensure immediate updates.
- JSONP Cross-Origin Fetching - Bypasses same-origin policy restrictions through a script-tag based padding mechanism for GET requests.
- JSONP Request Handlers - Bypasses same-origin policy restrictions by performing GET requests using JSON with padding.
- AngularJS Ecosystem - Simplifies RESTful API interactions in Angular.
- API Client Development Tools - Simplifies API requests in AngularJS.
- Client Libraries - AngularJS service for simplified interaction with RESTful resources.
