VR Juggler
Open Source
Virtual Reality


VRJ Wiki . VRJPlanning . RewriteJavaConfigCoreStory VRJ Wiki webs:
Juggler | VRJPlanning | Main | TWiki | Test
VRJPlanning . { Home | Changes | Index | Search | Go }

Wiki

· Home
· 2.0 Release
· 2.0 Beta 1
· 2.0 Alpha 4
· 2.0 Alpha 2
· 2.0 Alpha 1
· Development
· Direction
· Status

edit menu


Main
· About
· Documentation
· Publications
· Download
· HOWTO
· FAQ
· Discussion Area (Wiki)
· Status
· Contact

Projects
· VR Juggler
· Gadgeteer
· VPR
· Sonix
· JCCL
· Tweek
· PyJuggler
· VRJ.NET

Events
· SIGGRAPH 2004 BoF?
· SIGGRAPH 2003 BoF?
· Virtual Reality Course
· IEEE VR 2003 Course
· SC 2002 Exhibit

Site Search

Google

Sponsors
· Infiscape
· VRAC
· Iowa State University
· SourceForge

Link To Us


RewriteJavaConfigCoreStory

Story summary Rewrite the core part of the JCCL java configuration code.
Iteration VrjTwoZeroAlphaTwo
Development order 1
Customer  
Story Lead BenScott
FEA  
Acceptance Criteria  
Passed acceptance test Yes

Full story

The core Java code for JCCL is a complete mess. Among other problems, it fails to:

  • Do event notifications correctly when objects change.
  • Make it possible to support support multiple separate views into configuration.
  • Support a ConfigChunk version upgrade path
  • Be readable smile

For some time now, I have been trying to refactor the existing code to no avail. The existing codebase is far to inflexible to support current configuration needs. Therefore, a complete rewrite of the core Java configuration code is required.

Implementation notes

I am renaming the following concepts in order to reduce the number of times I have to explain what a "Chunk" is:

  • ConfigChunk is now ConfigElement
  • ChunkDesc is now ConfigDefinition
  • PropertyDesc is now PropertyDefinition
  • A PropertyDesc's item is now a PropertyValueDefinition

I am also revising the configuration definition file format in order to simplify configuration definition lookup rules and to support versioning. All version of each configuration definition shall be located in its own file named token.jdef. A search path shall be used to locate the configuration definition files. This allows us to no longer require the monolithic configuration definition file.

9 June 2003

Allen, Patrick, and I discussed the merits of using an environment variable to specify the configuration definition lookup path or having the path defined in the configuration file. It was deemed that having the path defined in configuration files would potentially make those file not portable in terms of moving between systems and even directories on the samte system. On the other hand, I feel that requiring the use of yet another environment variable would take us a step back in terms of usability. The jury is still out on this one. In the mean time, since I've already put together the architecture for using a path specified in the configuration file, that is there right now.

Tasks in this story

Tasks Est Spent To do Risk Reviewer Developer Task Name
Task 3 3 0 Low   BenScott Create ConfigElement to replace ConfigChunk.
Task 3 3 0 Low   BenScott Create ConfigDefinition to replace ChunkDesc.
Task 3 2 0 Low   BenScott Create PropertyDefinition to replace PropertyDesc.
Task 3 1 0 Medium   BenScott Create a framework for supporting multiple parsers to handle various file format versions.
Task 6 8 0 Medium   BenScott Write a parser for the new configuration definition file format.
Task 6 7 0 Medium   BenScott Write a parser for the configuration element file format.
Task 16 16 0 Low   BenScott Convert VrjConfig over to the new API.
Task 6 6 0 Medium   BenScott Rewrite the C++ PropertyDesc.
Task 6 6 0 Medium   BenScott Rewrite the C++ ChunkDesc.
Task 6 6 0 Medium   BenScott Rewrite the C++ ConfigChunk.

Task details:


Topic RewriteJavaConfigCoreStory . { Edit | Attach | Ref-By | Printable | Diffs | r1.6 | > | r1.5 | > | r1.4 | More }

Copyright © 1999-2008 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding VRJ Wiki? Send feedback
Revision r1.6 - 26 Jan 2004 - 16:52 - AronBierbaum Copyright © 1999-2008 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding VRJ Wiki? Send feedback




VR Juggler Logo
Site contents © Copyright 1998–2005 Iowa State University and released under the GPL.
Harvesting email addresses from this page for commercial activities is prohibited.
Contact: Webmaster | Write Us
SOURCE REPOSITORY,
BUGS, FORUMS
HOSTED BY:		 SourceForge Home