6.x
Intro
Configuration
Advanced Topics
Extending WireBox
Aspect Oriented Programming
Persistence DSL
The next step in our mapping DSL excursion is to learn about how WireBox will persist these object mappings into WireBox scopes. By default (as we have seen), all object mappings are transient objects and they belong to a scope type called NOSCOPE.
However, we need to specifically tell WireBox into what scope the declared mapped objects should be placed on in order for us to leverage caching, the singleton pattern, etc. This is accomplished by leveraging our persistence component annotations or the following methods if you prefer a non-annotation approach:
Note Please note that all WireBox configuration binders have two public properties:
1
this.TYPES - Enum class (coldbox.system.ioc.Types)
2
this.SCOPES - Enum class (coldbox.system.ioc.Scopes)
Copied!
These classes have on themselves several public properties that are a cool shorthand way to link to construction types or persistence scopes
Method Signature
Description
asSingleton()
Maps an object to the WireBox internal Singleton scope
into(scope)
Maps an object to a valid WireBox internal scope or any custom registered scopes by using the registered scope name. Valid internal WireBox scopes are: NOSCOPE PROTOTYPE SINGLETON SESSION APPLICATION REQUEST SERVER CACHEBOX
inCacheBox([key='mappingName'],[timeout],[lastAccessTimeout],[provider='default'])
asEagerInit()
Maps an object to be created immediately once the Injector is created. By default all object mappings are lazy loaded in construction.
So just remember that these persistence DSL methods are not mandatory. If you are an annotations kinda developer, then you can easily add these persistence annotations to your classes.
1
// CFC
2
map("FunkyObject")
3
.to("myapp.model.service.FunkyService")
4
.asSingleton();
5
mapPath("myapp.model.service.FunkyService")
6
.into(this.SCOPES.REQUEST);
7
// Java as NO SCOPE
8
map("buffer").toJava("java.lang.StringBuffer");
9
// RSS feed
10
map("googleNews")
11
.toRSS("http://news.google.com/news?output=rss")
12
.inCacheBox(timeout=60,lastAccessTimeout=15);
13
// Webservice
14
map("myWS")
15
.toWebservice("http://myapp.com/app.cfc?wsdl")
16
.into(this.SCOPES.APPLICATION);
Copied!
Caution Please note that by leveraging scopes that can expire such as cachebox,request,session,applications,etc you must take into account the way they are injected into other objects. They can experience a DI side effect called scope widening injection that can link an object reference that expires into another object reference that does not expire (like singleton). This causes nasty side effects and issues, so please refer to the WireBox Providers section to find out how you can avoid this nasty pitfall by using WireBox providers.
Copy link
Edit on GitHub