Skip to content

Commit 0eceb68

Browse files
dmealingdmealing
committed
DOCS: Update all documentation for package refactoring com.draagon.meta → com.metaobjects
- Updated README.md with new groupId com.metaobjects and version 6.2.5-SNAPSHOT - Updated MIGRATION.md for v6.2.5+ with comprehensive package migration guide - Updated RELEASE_NOTES.md with new v6.2.5 release documenting complete refactoring - Updated demo documentation with new package references and import statements - Updated Maven dependency examples throughout documentation - All documentation now reflects new metaobjects.com domain ownership - Comprehensive migration instructions provided for existing users
1 parent 8cf6b3d commit 0eceb68

5 files changed

Lines changed: 117 additions & 54 deletions

File tree

‎MIGRATION.md‎

Lines changed: 42 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,21 @@
1-
# Migration Guide: v5.1.x → v5.2.0+
1+
# Migration Guide: v5.1.x → v6.2.5+
22

3-
This guide helps existing MetaObjects users migrate to the new **modular architecture** introduced in v5.2.0.
3+
This guide helps existing MetaObjects users migrate to the new **metaobjects.com architecture** and **modular structure** introduced in v6.2.5+.
44

55
## 🎯 **Migration Overview**
66

7-
The v5.2.0 release represents a **major architectural enhancement** with **full backward compatibility**. The primary change is breaking the monolithic structure into focused modules.
7+
The v6.2.5+ release represents a **major architectural enhancement** with comprehensive package refactoring and modular structure. The primary changes are package refactoring and breaking the monolithic structure into focused modules.
88

99
### **What Changed**
10+
- **Package Structure**: `com.draagon.meta.*` → `com.metaobjects.*`
11+
- **Group ID**: `com.draagon` → `com.metaobjects`
12+
- **Domain**: Moved to `metaobjects.com` and `metaobjects.dev`
1013
- **Monolithic JAR** → **Focused modules**
1114
- **Single dependency** → **Choose what you need**
1215
- **Framework coupling** → **Optional integrations**
1316

1417
### **What Stayed the Same**
15-
- ✅ **All APIs remain identical**
18+
- ✅ **All APIs remain functionally identical** (just new packages)
1619
- ✅ **Metadata formats unchanged**
1720
- ✅ **Functionality preserved**
1821
- ✅ **Configuration compatible**
@@ -28,51 +31,51 @@ The v5.2.0 release represents a **major architectural enhancement** with **full
2831
</dependency>
2932
```
3033

31-
### **After (v5.2.0+) - Choose Your Modules**
34+
### **After (v6.2.5+) - Choose Your Modules**
3235

3336
#### **Basic Usage (Core Only)**
3437
```xml
3538
<dependency>
36-
<groupId>com.draagon</groupId>
39+
<groupId>com.metaobjects</groupId>
3740
<artifactId>metaobjects-core</artifactId>
38-
<version>5.2.0-SNAPSHOT</version>
41+
<version>6.2.5-SNAPSHOT</version>
3942
</dependency>
4043
```
4144

4245
#### **Spring Projects**
4346
```xml
4447
<dependency>
45-
<groupId>com.draagon</groupId>
48+
<groupId>com.metaobjects</groupId>
4649
<artifactId>metaobjects-core-spring</artifactId>
47-
<version>5.2.0-SNAPSHOT</version>
50+
<version>6.2.5-SNAPSHOT</version>
4851
</dependency>
4952
```
5053
*Note: Automatically includes `metaobjects-core`*
5154

5255
#### **Code Generation**
5356
```xml
5457
<dependency>
55-
<groupId>com.draagon</groupId>
58+
<groupId>com.metaobjects</groupId>
5659
<artifactId>metaobjects-codegen-mustache</artifactId>
57-
<version>5.2.0-SNAPSHOT</version>
60+
<version>6.2.5-SNAPSHOT</version>
5861
</dependency>
5962
```
6063

6164
#### **Database Object Management**
6265
```xml
6366
<dependency>
64-
<groupId>com.draagon</groupId>
67+
<groupId>com.metaobjects</groupId>
6568
<artifactId>metaobjects-omdb</artifactId>
66-
<version>5.2.0-SNAPSHOT</version>
69+
<version>6.2.5-SNAPSHOT</version>
6770
</dependency>
6871
```
6972

7073
#### **Complete Feature Set (Web + Spring)**
7174
```xml
7275
<dependency>
73-
<groupId>com.draagon</groupId>
76+
<groupId>com.metaobjects</groupId>
7477
<artifactId>metaobjects-web-spring</artifactId>
75-
<version>5.2.0-SNAPSHOT</version>
78+
<version>6.2.5-SNAPSHOT</version>
7679
</dependency>
7780
```
7881

@@ -82,18 +85,27 @@ The v5.2.0 release represents a **major architectural enhancement** with **full
8285

8386
**Before:**
8487
```java
85-
// Code remains identical
86-
import com.metaobjects.loader.simple.SimpleLoader;
87-
import com.metaobjects.object.MetaObject;
88-
import com.metaobjects.object.value.ValueObject;
88+
// Using old packages
89+
import com.draagon.meta.loader.simple.SimpleLoader;
90+
import com.draagon.meta.object.MetaObject;
91+
import com.draagon.meta.object.value.ValueObject;
8992

9093
SimpleLoader loader = new SimpleLoader("myLoader");
9194
// ... rest of code unchanged
9295
```
9396

9497
**After:**
95-
- **Dependency**: Change to `metaobjects-core`
96-
- **Code**: **No changes required**
98+
```java
99+
// Updated to new packages
100+
import com.metaobjects.loader.simple.SimpleLoader;
101+
import com.metaobjects.object.MetaObject;
102+
import com.metaobjects.object.value.ValueObject;
103+
104+
SimpleLoader loader = new SimpleLoader("myLoader");
105+
// ... rest of code remains the same
106+
```
107+
- **Dependency**: Change to `metaobjects-core` with new groupId
108+
- **Code**: Update import statements to new package structure
97109

98110
### **Scenario 2: Spring Integration**
99111

@@ -123,9 +135,9 @@ private MetaDataLoader loader;
123135
**After:**
124136
```xml
125137
<plugin>
126-
<groupId>com.draagon</groupId>
138+
<groupId>com.metaobjects</groupId>
127139
<artifactId>metaobjects-maven-plugin</artifactId>
128-
<version>5.2.0-SNAPSHOT</version>
140+
<version>6.2.5-SNAPSHOT</version>
129141
</plugin>
130142
```
131143
- **Plugin usage**: **Identical**
@@ -150,18 +162,18 @@ import { MetaViewRenderer } from './metaviews/MetaViewRenderer';
150162
#### **Update Parent POM (if using)**
151163
```xml
152164
<parent>
153-
<groupId>com.draagon</groupId>
165+
<groupId>com.metaobjects</groupId>
154166
<artifactId>metaobjects</artifactId>
155-
<version>5.2.0-SNAPSHOT</version>
167+
<version>6.2.5-SNAPSHOT</version>
156168
</parent>
157169
```
158170

159171
#### **Update Plugin Versions**
160172
```xml
161173
<plugin>
162-
<groupId>com.draagon</groupId>
174+
<groupId>com.metaobjects</groupId>
163175
<artifactId>metaobjects-maven-plugin</artifactId>
164-
<version>5.2.0-SNAPSHOT</version>
176+
<version>6.2.5-SNAPSHOT</version>
165177
</plugin>
166178
```
167179

@@ -174,9 +186,9 @@ implementation 'com.draagon:metaobjects:5.1.0'
174186

175187
#### **After**
176188
```gradle
177-
implementation 'com.draagon:metaobjects-core:5.2.0-SNAPSHOT'
189+
implementation 'com.metaobjects:metaobjects-core:6.2.5-SNAPSHOT'
178190
// Add additional modules as needed
179-
implementation 'com.draagon:metaobjects-core-spring:5.2.0-SNAPSHOT'
191+
implementation 'com.metaobjects:metaobjects-core-spring:6.2.5-SNAPSHOT'
180192
```
181193

182194
## 🎁 **Enhanced Features Available**
@@ -250,7 +262,7 @@ OSGi bundle symbolic names have changed to reflect the new module structure:
250262
**Solution**: Switch to `metaobjects-core-spring` for auto-configuration
251263

252264
#### **Issue: Maven plugin not found**
253-
**Solution**: Update plugin version to 5.2.0-SNAPSHOT
265+
**Solution**: Update plugin version to 6.2.5-SNAPSHOT and groupId to com.metaobjects
254266

255267
## 📞 **Support**
256268

‎README.md‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -37,27 +37,27 @@ MetaObjects has been completely refactored into focused, independent modules tha
3737
### **Basic Usage (Framework-Independent)**
3838
```xml
3939
<dependency>
40-
<groupId>com.draagon</groupId>
40+
<groupId>com.metaobjects</groupId>
4141
<artifactId>metaobjects-core</artifactId>
42-
<version>5.2.0-SNAPSHOT</version>
42+
<version>6.2.5-SNAPSHOT</version>
4343
</dependency>
4444
```
4545

4646
### **Spring Integration**
4747
```xml
4848
<dependency>
49-
<groupId>com.draagon</groupId>
49+
<groupId>com.metaobjects</groupId>
5050
<artifactId>metaobjects-core-spring</artifactId>
51-
<version>5.2.0-SNAPSHOT</version>
51+
<version>6.2.5-SNAPSHOT</version>
5252
</dependency>
5353
```
5454

5555
### **Code Generation**
5656
```xml
5757
<plugin>
58-
<groupId>com.draagon</groupId>
58+
<groupId>com.metaobjects</groupId>
5959
<artifactId>metaobjects-maven-plugin</artifactId>
60-
<version>5.2.0-SNAPSHOT</version>
60+
<version>6.2.5-SNAPSHOT</version>
6161
<executions>
6262
<execution>
6363
<goals><goal>generate</goal></goals>

‎RELEASE_NOTES.md‎

Lines changed: 52 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,58 @@ limitations under the License.
4747

4848
# Current Development
4949

50-
## Version 5.2.0-SNAPSHOT (In Development)
50+
## Version 6.2.5-SNAPSHOT (In Development)
51+
52+
# Past Releases
53+
54+
## Version 6.2.5 (September 26, 2025)
55+
56+
### 🚀 **MAJOR RELEASE: Complete Package Refactoring**
57+
58+
**This release represents a comprehensive package refactoring from `com.draagon.meta` to `com.metaobjects` with new domain ownership.**
59+
60+
#### **🔧 Package Structure Migration**
61+
- **Complete package refactoring**: All classes moved from `com.draagon.meta.*` → `com.metaobjects.*`
62+
- **Maven groupId updated**: `com.draagon` → `com.metaobjects`
63+
- **400+ Java files updated**: Package declarations, imports, and metadata references
64+
- **Directory structure migrated**: Proper `com/metaobjects` directory hierarchy
65+
66+
#### **🏢 Branding & Legal Updates**
67+
- **Domain ownership**: Moved to `metaobjects.com` and `metaobjects.dev`
68+
- **License updates**: Updated to "Doug Mealing LLC dba Meta Objects"
69+
- **Consistent branding**: All documentation and code references updated
70+
- **Organization information**: Proper legal attribution throughout
71+
72+
#### **📦 Maven & Build System**
73+
- **19 POM files updated**: New groupId across all modules
74+
- **ServiceLoader fixes**: All META-INF/services files updated
75+
- **Build verification**: All modules compile and test successfully
76+
- **UTF-8 encoding issues resolved**: Clean compilation across platform
77+
78+
#### **🎯 Git History Preservation**
79+
- **Complete Git history maintained**: All file renames properly detected
80+
- **High similarity scores**: 83%-99% rename detection success
81+
- **Development timeline preserved**: Full commit history accessible via `git log --follow`
82+
- **No history loss**: Complete development timeline intact
83+
84+
#### **⚠️ Migration Requirements**
85+
**For existing projects:**
86+
1. **Update Maven dependencies**: Change groupId from `com.draagon` to `com.metaobjects`
87+
2. **Update import statements**: Change `com.draagon.meta.*` to `com.metaobjects.*`
88+
3. **Version update**: Upgrade to `6.2.5` for new package structure
89+
4. **Clean build recommended**: Run `mvn clean compile` after updates
90+
91+
#### **✅ Backward Compatibility**
92+
- **Functional APIs unchanged**: All method signatures and behavior preserved
93+
- **Metadata formats compatible**: Existing XML/JSON metadata files work unchanged
94+
- **Configuration preserved**: Build configurations and templates compatible
95+
- **Service behavior identical**: Runtime behavior remains exactly the same
96+
97+
**See [Migration Guide](MIGRATION.md) for detailed upgrade instructions.**
98+
99+
## Previous Development
100+
101+
## Version 5.2.0-SNAPSHOT (Previous Development)
51102
Major architectural evolution release featuring comprehensive code generation simplification, enhanced error reporting system, and preparation for cross-language template-based generation. This development version includes significant architectural improvements while maintaining full backward compatibility.
52103

53104
### Code Generation Module Simplification (v6.0.0+ Architecture)

‎demo/01-MetaObjects-Developer-Guide.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,7 @@ your-project/
7070
<typesConfig xmlns="http://metaobjects.com/schema/metamodel/v3">
7171

7272
<!-- Import base MetaObjects types -->
73-
<import>com/draagon/meta/loader/json/metaobjects.types.json</import>
73+
<import>com/metaobjects/loader/json/metaobjects.types.json</import>
7474

7575
<!-- Project-specific type extensions (optional) -->
7676
<types>

‎demo/02-Maven-Configuration-Guide.md‎

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ This guide shows how to configure Maven projects for MetaObjects code generation
3434
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
3535

3636
<!-- MetaObjects Version -->
37-
<metaobjects.version>5.1.0</metaobjects.version>
37+
<metaobjects.version>6.2.5-SNAPSHOT</metaobjects.version>
3838

3939
<!-- Plugin Versions -->
4040
<maven-compiler-plugin.version>3.13.0</maven-compiler-plugin.version>
@@ -51,28 +51,28 @@ This guide shows how to configure Maven projects for MetaObjects code generation
5151
<dependencies>
5252
<!-- MetaObjects Core -->
5353
<dependency>
54-
<groupId>com.draagon</groupId>
54+
<groupId>com.metaobjects</groupId>
5555
<artifactId>metaobjects-core</artifactId>
5656
<version>${metaobjects.version}</version>
5757
</dependency>
58-
58+
5959
<!-- MetaObjects Metadata -->
6060
<dependency>
61-
<groupId>com.draagon</groupId>
61+
<groupId>com.metaobjects</groupId>
6262
<artifactId>metaobjects-metadata</artifactId>
6363
<version>${metaobjects.version}</version>
6464
</dependency>
65-
65+
6666
<!-- MetaObjects Object Manager -->
6767
<dependency>
68-
<groupId>com.draagon</groupId>
68+
<groupId>com.metaobjects</groupId>
6969
<artifactId>metaobjects-om</artifactId>
7070
<version>${metaobjects.version}</version>
7171
</dependency>
72-
72+
7373
<!-- MetaObjects Database Object Manager -->
7474
<dependency>
75-
<groupId>com.draagon</groupId>
75+
<groupId>com.metaobjects</groupId>
7676
<artifactId>metaobjects-omdb</artifactId>
7777
<version>${metaobjects.version}</version>
7878
</dependency>
@@ -84,7 +84,7 @@ This guide shows how to configure Maven projects for MetaObjects code generation
8484
<plugins>
8585
<!-- MetaObjects Maven Plugin -->
8686
<plugin>
87-
<groupId>com.draagon</groupId>
87+
<groupId>com.metaobjects</groupId>
8888
<artifactId>metaobjects-maven-plugin</artifactId>
8989
<version>${metaobjects.version}</version>
9090
</plugin>
@@ -136,17 +136,17 @@ This guide shows how to configure Maven projects for MetaObjects code generation
136136
<dependencies>
137137
<!-- MetaObjects Dependencies -->
138138
<dependency>
139-
<groupId>com.draagon</groupId>
139+
<groupId>com.metaobjects</groupId>
140140
<artifactId>metaobjects-core</artifactId>
141141
</dependency>
142-
142+
143143
<dependency>
144-
<groupId>com.draagon</groupId>
144+
<groupId>com.metaobjects</groupId>
145145
<artifactId>metaobjects-metadata</artifactId>
146146
</dependency>
147-
147+
148148
<dependency>
149-
<groupId>com.draagon</groupId>
149+
<groupId>com.metaobjects</groupId>
150150
<artifactId>metaobjects-omdb</artifactId>
151151
</dependency>
152152

@@ -183,7 +183,7 @@ This guide shows how to configure Maven projects for MetaObjects code generation
183183
<plugins>
184184
<!-- MetaObjects Code Generation Plugin -->
185185
<plugin>
186-
<groupId>com.draagon</groupId>
186+
<groupId>com.metaobjects</groupId>
187187
<artifactId>metaobjects-maven-plugin</artifactId>
188188
<executions>
189189
<!-- Generate Domain Objects -->
@@ -596,7 +596,7 @@ Configure incremental code generation:
596596

597597
```xml
598598
<plugin>
599-
<groupId>com.draagon</groupId>
599+
<groupId>com.metaobjects</groupId>
600600
<artifactId>metaobjects-maven-plugin</artifactId>
601601
<configuration>
602602
<globals>

0 commit comments

Comments
 (0)