dev library
Dev/JIT-only entrypoint for package:conduit_core.
Re-exports the mirror-based ConduitCompiler and friends. Production
AOT-compiled code should import package:conduit_core/conduit_core.dart
instead, which omits these.
Classes
- APIConfiguration
- A Configuration to represent an external HTTP API.
-
Application<
T extends ApplicationChannel> - This object starts and stops instances of your ApplicationChannel.
- ApplicationChannel
- An object that defines the behavior specific to your application.
- ApplicationMessageHub
- An object that sends and receives messages between ApplicationChannels.
- ApplicationOptions
- An object that contains configuration values for an Application.
- ApplicationServer
- Listens for HTTP requests and delivers them to its ApplicationChannel instance.
- AuthBasicCredentials
- A structure to hold Basic authorization credentials.
- AuthClient
- Represents an OAuth 2.0 client ID and secret pair.
- AuthCode
- Represents an OAuth 2.0 authorization code.
- AuthCodeController
- Controller for issuing OAuth 2.0 authorization codes.
- AuthCodeControllerDelegate
- Provides AuthCodeController with application-specific behavior.
- AuthController
- Controller for issuing and refreshing OAuth 2.0 access tokens.
- Authorization
- Authorization information for a Request after it has passed through an Authorizer.
- AuthorizationBasicParser
- Parses a Basic Authorization header.
- AuthorizationBearerParser
- Parses a Bearer token from an Authorization header.
-
AuthorizationParser<
T> - Authorizer
- A Controller that validates the Authorization header of a request.
- AuthRedirectController
- Controller for issuing OAuth 2.0 authorization codes and tokens.
- AuthRedirectControllerDelegate
- Provides AuthRedirectController with application-specific behavior.
- AuthScope
- Instances represent OAuth 2.0 scope.
- AuthServer
- A OAuth 2.0 authorization server.
- AuthServerDelegate
- The methods used by an AuthServer to store information and customize behavior related to authorization.
- AuthToken
- Represents an OAuth 2.0 token.
- BetweenExpression
-
Range expression:
<target> BETWEEN <low> AND <high>orNOT BETWEEN. - BinaryOpExpression
-
Binary infix expression:
<left> <op> <right>. - Bind
- Binds elements of an HTTP request to a ResourceController's operation method arguments and properties.
- BodyDecoder
- Decodes bytes according to contentType.
- CachePolicy
- Instances of this type provide configuration for the 'Cache-Control' header.
- ChannelRuntime
- CodecRegistry
- Provides encoding and decoding services based on the ContentType of a Request or Response.
- Column
- Metadata to describe the behavior of the underlying database column of a persistent property in ManagedObject subclasses.
- ColumnBuilder
- ColumnExpression
-
A reference to a column by name. Optionally namespaced by table
(the dialect's visitor decides whether to include the namespace
based on context — e.g., when a
JOINis present). - ColumnExpressionBuilder
- ColumnSortBuilder
- ColumnSortPredicateBuilder
- ColumnValueBuilder
- ComparisonExpression
- ConduitCompiler
-
Discovers conduit_core's runtime types via
dart:mirrorsfor the JIT/dev fallback. Under AOT, the build_runner-generatedbootstrap()installs the registry directly and this class is unreachable. - Configuration
- Subclasses of Configuration read YAML strings and files, assigning values from the YAML document to properties of an instance of this type.
- ConfigurationCompiler
-
Registers
Configurationsubclasses with the JIT/dev mirror fallback. Under AOT, the build_runner-generatedbootstrap()installs the registry directly and this class is unreachable. - ConfigurationError
- Thrown when Configuration subclass is invalid and requires a change in code.
- ConfigurationException
- Thrown when reading data into a Configuration fails.
- ConfigurationItemAttribute
- Configuration properties may be attributed with these.
- ConfigurationRuntime
- Controller
- Base class for request handling objects.
- ControllerRuntime
- CORSPolicy
- Describes a CORS policy for a Controller.
- DatabaseConfiguration
- A Configuration to represent a database connection configuration.
- Document
- Allows storage of unstructured data in a ManagedObject property.
- FileController
- Serves files from a directory on the filesystem.
- InExpression
-
Set-membership expression:
<target> IN (<v1>, <v2>, ...)orNOT IN. - InstanceWrapper
- IsNullExpression
-
Null-check expression:
<operand> IS NULLor<operand> IS NOT NULL. - KeyPath
- Level
- Levels to control logging output. Logging can be enabled to include all levels above certain Level. Levels are ordered using an integer value Level.value. The predefined Level constants below are sorted as follows (in descending order): Level.SHOUT, Level.SEVERE, Level.WARNING, Level.INFO, Level.CONFIG, Level.FINE, Level.FINER, Level.FINEST, and Level.ALL.
- LikeExpression
-
Pattern-match expression:
<target> LIKE <pattern>(case-sensitive) or its case-insensitive sibling. The dialect chooses the operator (LIKE/ILIKE/LIKE BINARY) and applies escape rules topatternif needed. - Linkable
- An interface for linking controllers.
- LiteralExpression
- A literal SQL token. Only a small number of safe constants are emitted via this node (e.g., the numeric literal bounds for page-cursor predicates) — any user-supplied value goes through ParameterExpression instead so the dialect can bind it safely.
- Logger
- Use a Logger to log debug messages.
- LogicalExpression
- Logical combinator: AND / OR over an arbitrary number of children.
- LogRecord
- A log entry representation used to propagate information from Logger to individual handlers.
- ManagedAttributeDescription
- Stores the specifics of database columns in ManagedObjects as indicated by Column.
- ManagedBacking
- Instances of this class provide storage for ManagedObjects.
- ManagedContext
- A service object that handles connecting to and sending queries to a database.
- ManagedDataModel
- Instances of this class contain descriptions and metadata for mapping ManagedObjects to database rows.
- ManagedEntity
- Mapping information between a table in a database and a ManagedObject object.
- ManagedEntityRuntime
-
ManagedObject<
T> - An object that represents a database row.
-
ManagedObjectController<
InstanceType extends ManagedObject> - A Controller that implements basic CRUD operations for a ManagedObject.
- ManagedPropertyDescription
- Contains database column information and metadata for a property of a ManagedObject object.
- ManagedRelationshipDescription
- Contains information for a relationship property of a ManagedObject.
-
ManagedSet<
InstanceType extends ManagedObject> - Instances of this type contain zero or more instances of ManagedObject and represent has-many relationships.
- ManagedType
- Complex type storage for ManagedEntity attributes.
- ManagedValidator
- Validates properties of ManagedObject before an insert or update Query.
- Migration
- The base class for migration instructions.
- NamedSqlExpressionVisitor
-
Visitor base for named-parameter dialects (
@namefor Postgres,:namefor SQLite). Subclasses overriderenderPlaceholderto produce the dialect-specific prefix. - NullCheckExpression
- Operation
- Binds an instance method in ResourceController to an operation.
- ParameterExpression
-
A bind-parameter slot. The visitor renders this as a
dialect-correct placeholder (
@namefor Postgres,:namefor SQLite,?for MySQL) and records the bound value in its accumulating parameter list/map. -
Persistence<
G extends Object> - Unified handle for an application's persistence layer.
- PersistentStore
- An interface for implementing persistent storage.
- PositionalSqlExpressionVisitor
-
Visitor base for positional-parameter dialects (
?for MySQL). Each ParameterExpression appends topositionalParametersin SQL-string order; placeholders all render as?. - PredicateExpression
-
Query<
InstanceType extends ManagedObject> - An object for configuring and executing a database query.
- QueryBuilder
-
QueryController<
InstanceType extends ManagedObject> - A partial class for implementing an ResourceController that has a few conveniences for executing Querys.
-
QueryExpression<
T, InstanceType> - Contains methods for adding logical expressions to properties when building a Query.
-
QueryExpressionJunction<
T, InstanceType> - Contains binary logic operations to be applied to a QueryExpression.
- QueryPredicate
- A predicate contains instructions for filtering rows when performing a Query.
-
QueryReduceOperation<
T extends ManagedObject> - Executes aggregate functions like average, count, sum, etc.
- QuerySortPredicate
- The order in which a collection of objects should be sorted when returned from a database.
- RangeExpression
- RawExpression
-
Escape hatch — emit a raw SQL fragment with named-parameter
bindings. Used to bridge predicates that downstream user code
constructed via the legacy
QueryPredicate(format, parameters)constructor. The visitor renders the fragment verbatim under named-parameter dialects, and rewrites named placeholders to positional ones under positional-parameter dialects. -
Recyclable<
T> - An interface that Controller subclasses implement to generate a controller for each request.
- Relate
- Metadata to configure property of ManagedObject as a foreign key column.
- RenderedExpression
-
The output of a render pass: a SQL fragment (the predicate body —
what would go after
WHERE) plus the parameter binding shape the dialect prefers. - Request
- A single HTTP request.
- RequestBody
- Objects that represent a request body, and can be decoded into Dart objects.
- RequestOrResponse
- The unifying protocol for Request and Response classes.
- RequestPath
- Stores path info for a Request.
- RequiredBinding
- See requiredBinding.
- ResourceController
- Controller for operating on an HTTP Resource.
- ResourceControllerDocumenter
- ResourceControllerOperation
- ResourceControllerOperationInvocationArgs
- ResourceControllerParameter
- ResourceControllerRuntime
- ResourceOwner
- The properties of an OAuth 2.0 Resource Owner.
- Response
- Represents the information in an HTTP response.
- ResponseKey
- An annotation used to specify how a field is serialized in API responses.
- ResponseModel
- An annotation used to specify how a Model is serialized in API responses.
- Returnable
- Common interface for values that can be mapped to/from a database.
- Rollback
- Throw this object to roll back a ManagedContext.transaction.
- RouteNode
- Router
- Determines which Controller should receive a Request based on its path.
- RouteSegment
- RouteSpecification
- Specifies a matchable route path.
- RowInstantiator
- Schema
- A portable representation of a database schema.
- SchemaBuilder
- Generates SQL or Dart code that modifies a database schema.
- SchemaColumn
- A portable representation of a database column.
- SchemaColumnDifference
- The difference between two compared SchemaColumns.
- SchemaDifference
- The difference between two compared Schemas.
- SchemaTable
- A portable representation of a database table.
- SchemaTableDifference
- The difference between two SchemaTables.
- SchemaTableUniqueSetDifference
- Difference between two SchemaTable.uniqueColumnSets.
- Scope
- Allows ResourceControllers to have different scope for each operation method.
- Serializable
- Interface for serializable instances to be decoded from an HTTP request body and encoded to an HTTP response body.
- SerializableRuntime
- Serialize
- Annotation for ManagedObject properties that allows them to participate in ManagedObject.asMap and/or ManagedObject.readFromMap.
- SetMembershipExpression
- SqlDialect
- SqlExpression
- Base class for every node in the predicate AST.
-
SqlExpressionVisitor<
T> - Visitor pattern entry point for predicate AST traversal.
- StringExpression
- Table
- Annotation to configure the table definition of a ManagedObject.
- TableBuilder
- UnaryOpExpression
-
Unary prefix expression:
<op> <operand>. Currently used only forNOT; included as a node kind so backends can extend it without adding a new visitor method. - Validate
- Add as metadata to persistent properties to validate their values before insertion or updating.
- ValidationContext
- Information about a validation being performed.
Enums
- AuthorizationParserExceptionReason
- The reason either AuthorizationBearerParser or AuthorizationBasicParser failed.
- AuthRequestError
- The possible errors as defined by the OAuth 2.0 specification.
- BindingType
- ConfigurationItemAttributeType
- Possible options for a configuration item property's optionality.
- DeleteRule
- Possible values for a delete rule in a Relate.
- ManagedPropertyType
- Possible data types for ManagedEntity attributes.
- ManagedRelationshipType
- The possible database relationships.
- PersistentStoreQueryReturnType
- PredicateOperator
- The operator in a comparison matcher.
- PredicateStringOperator
- The operator in a string matcher.
- QueryExceptionEvent
- Categorizations of query failures for QueryException.
- QuerySortOrder
- Order value for Query.pageBy and Query.sortBy.
- SqlParameterStyle
-
Whether a dialect uses named parameters (
@name/:name) or positional ones (?). Drives which visitor implementation SqlDialect.renderExpression constructs. - Validating
- Types of operations ManagedValidators will be triggered for.
Mixins
- AuthValidator
- Instances that implement this type can be used by an Authorizer to determine authorization of a request.
-
QueryMixin<
InstanceType extends ManagedObject>
Constants
- defaultLevel → const Level
- The default Level.
- primaryKey → const Column
- Primary key annotation for a ManagedObject table definition property.
- requiredBinding → const RequiredBinding
- Marks an ResourceController property binding as required.
Properties
- hierarchicalLoggingEnabled ↔ bool
-
Whether to allow fine-grain logging and configuration of loggers in a
hierarchy.
getter/setter pair
- recordStackTraceAtLevel ↔ Level
-
Automatically record stack traces for any message of this level or above.
getter/setter pair
Functions
-
generateAPICredentialPair(
String clientID, String? secret, {String? redirectURI, int hashLength = 32, int hashRounds = 1000, Hash? hashFunction}) → AuthClient - A utility method to generate a ClientID and Client Secret Pair.
-
generatePasswordHash(
String password, String salt, {int hashRounds = 1000, int hashLength = 32, Hash? hashFunction}) → String - A utility method to generate a password hash using the PBKDF2 scheme.
-
generateRandomSalt(
{int hashLength = 32}) → String - A utility method to generate a random base64 salt.
-
randomStringOfLength(
int length) → String -
startApplication<
T extends ApplicationChannel> (Application< T> app, int isolateCount, SendPort parentPort) → Future
Typedefs
-
FileControllerClosure
= FutureOr<
Response> Function(FileController controller, Request req)
Exceptions / Errors
- ApplicationStartupException
- Thrown when an application encounters an exception during startup.
- AuthorizationParserException
- An exception indicating why Authorization parsing failed.
- AuthServerException
- An exception thrown by AuthServer.
- HandlerException
- HTTPStreamingException
- ManagedDataModelError
- Thrown when a ManagedDataModel encounters an error.
- MigrationException
- Thrown when Migration encounters an error.
-
QueryException<
T> - An exception describing an issue with a query.
- SchemaException
- Thrown when a Schema encounters an error.
- SerializableException
- ValidateCompilationError
- An error thrown during validator compilation.
- ValidationException
- An exception thrown when an ORM property validator is violated.