The project tag defines a unique name for the Reactor project. To completely understand how this tag works you must understand how Reactor generates files. If you don't yet understand this then the following might not mean much to you. In this case simply follow the naming rules for the value attribute.
When Reactor generates files it creates two types of files, customizable files and project files. The DBMS agnostic customizable file extends the project file. The project file is generated under the "/reactor/project" folder. This is done for two reasons:
The project files are not safe to edit. Placing these files under the framework itself helps discourage developers from editing them.
It makes projects more portable and easily deployed. (Just trust me on this one.)
The value attribute of the project tag defines the name of the project and therefore the name of the folder in which project files are generated under "/reactor/project". For example, if my project were called "HelloWorld" my project files would be created in "/reactor/project/scratch". The customizable DBMS agnostic files extend files in the project folder. For example, helloWorldData.record.UserRecord extends reactor.project.helloWorld.record.UserRecord.
For more information on the structure of Reactor generated files see The Reactor Generated Files section in the Reactor Crash Course and The Structure of Reactor Generated Files.
It is not advisable to have two different applications use the same project name. However, multiple instances of the same exact application (such as multiple instances of a blog application) can use the same project name and share the generated project files.
|
Attribute |
Required |
Description |
|---|---|---|
|
value |
Yes |
Defines the name unique name for the Reactor project. The value provided must follow the same conventions as allowed in variable naming. For example, no spaces, punctuation, etc. |
None
<reactor>
<config>
<project
value="Scratch" />
<dsn
value="scratch" />
<type
value="mssql" />
<mapping
value="/reactorData" />
<mode
value="always" />
</config>
</reactor>