Summary
adds a new Alias for a class, namespace or package.
- Assembly
- Db4objects
.Db4o-2010 .dll - Namespace
- Db4objects
.Db4o .Config - Containing Type
- IConfiguration
Syntax
void AddAlias(IAlias alias)
Remarks
adds a new Alias for a class, namespace or package.
Aliases can be used to persist classes in the running application to different persistent classes in a database file or on a db4o server.
Two simple Alias implementations are supplied along with db4o:
-
-
It is possible to create own complex
Four examples of concrete usecases:
Aliases that translate the persistent name of a class to a name that already exists as a persistent name in the database (or on the server) are not permitted and will throw an exception when the database file is opened.
Aliases should be configured before opening a database file or connecting to a server.
Aliases can be used to persist classes in the running application to different persistent classes in a database file or on a db4o server.
Two simple Alias implementations are supplied along with db4o:
-
Db4objects.Db4o.Config.TypeAlias
provides an #equals() resolver to match names directly.
-
Db4objects.Db4o.Config.WildcardAlias
allows simple pattern matching with one single '*' wildcard
character.
It is possible to create own complex
Db4objects.Db4o.Config.IAlias
constructs by creating own resolvers that implement the
Db4objects.Db4o.Config.IAlias
interface.
Four examples of concrete usecases:
// Creating an Alias for a single class
Db4oFactory.Configure().AddAlias(
new TypeAlias("Tutorial.F1.Pilot", "Tutorial.F1.Driver"));
// Accessing a Java package from a .NET assembly
Db4o.configure().addAlias(
new WildcardAlias(
"com.f1.*",
"Tutorial.F1.*, Tutorial"));
// Using a different local .NET assembly
Db4o.configure().addAlias(
new WildcardAlias(
"Tutorial.F1.*, Tutorial",
"Tutorial.F1.*, RaceClient"));
Aliases that translate the persistent name of a class to a name that already exists as a persistent name in the database (or on the server) are not permitted and will throw an exception when the database file is opened.
Aliases should be configured before opening a database file or connecting to a server.
Parameters
Name | Type | Description |
---|---|---|
alias | IAlias |
Return Value
Type | Description |
---|---|
void |