Skip to content

Commit ea00f2b

Browse files
Remove internal hostnames and project references from modernization plan
Replace penguin references with generic Apache httpd / localhost. Replace RAPI-specific references with generic Axis2 JSON-RPC terminology. The modernization plan is published on GitHub and should not contain internal infrastructure names. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 03b1acd commit ea00f2b

1 file changed

Lines changed: 13 additions & 13 deletions

File tree

AXIS2_MODERNIZATION_PLAN.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -23,10 +23,10 @@ entirely. No other Java framework can do all three from the same service deploym
2323

2424
---
2525

26-
## Immediate Track — MCP inputSchema + Axis2/C + Penguin Demo
26+
## Immediate Track — MCP inputSchema + Axis2/C + Apache httpd Demo
2727

2828
**Goal**: Complete the MCP catalog to production quality, port the catalog handler to
29-
Axis2/C, and run a live demo on penguin via Apache httpd. This track runs ahead of
29+
Axis2/C, and run a live demo on Apache httpd with mod_axis2. This track runs ahead of
3030
Phases 1–6 because it validates the MCP story end-to-end on real hardware.
3131

3232
### Step B1 — `mcpInputSchema` static parameter support (Java + C)
@@ -171,9 +171,9 @@ it. The 5 operations:
171171
| `generateTestData` | `n_assets` |
172172
| `metadata` | *(none — GET operation)* |
173173

174-
### Step E — Penguin deployment
174+
### Step E — Apache httpd deployment
175175

176-
1. Build `mod_axis2.so` from `axis-axis2-c-core` targeting penguin's Apache httpd
176+
1. Build `mod_axis2.so` from `axis-axis2-c-core` targeting the host's Apache httpd
177177
2. `httpd.conf` fragment:
178178
```apache
179179
LoadModule axis2_module modules/mod_axis2.so
@@ -185,8 +185,8 @@ it. The 5 operations:
185185
3. Deploy `FinancialBenchmarkService` to repository
186186
4. Verify:
187187
```bash
188-
curl https://penguin/axis2/_mcp/openapi-mcp.json
189-
curl -X POST https://penguin/axis2/services/FinancialBenchmarkService/monteCarlo \
188+
curl https://localhost/axis2/_mcp/openapi-mcp.json
189+
curl -X POST https://localhost/axis2/services/FinancialBenchmarkService/monteCarlo \
190190
-H 'Content-Type: application/json' \
191191
-d '{"monteCarlo":[{"arg0":{"n_simulations":10000,"n_periods":252,...}}]}'
192192
```
@@ -340,9 +340,9 @@ Phase 1 (starter) — OpenAPI endpoints auto-registered via starter autoconfigur
340340
JSON-RPC path and a new REST path, with proper HTTP method semantics and
341341
resource-oriented URLs.
342342

343-
**Problem today**: RAPI's service URLs (`POST /services/getAssetCalculationsService/
344-
doGetAssetCalculationsJob`) are JSON-RPC over HTTP. New consumers (Data API, React
345-
frontend, MCP agents) expect `GET /api/v1/funds/{id}/calculations`. Axis2 has REST
343+
**Problem today**: Existing Axis2 service URLs (`POST /services/calculationService/
344+
doCalculationJob`) are JSON-RPC over HTTP. New consumers (REST APIs, React
345+
frontends, MCP agents) expect `GET /api/v1/resources/{id}/calculations`. Axis2 has REST
346346
dispatch capability in `axis2.xml` but it has never been activated or documented for
347347
modern Spring Boot deployments.
348348

@@ -395,8 +395,8 @@ modern Spring Boot deployments.
395395

396396
### Deliverable
397397
Existing Axis2 services add `@RestMapping` annotations and are immediately available
398-
as REST endpoints alongside their JSON-RPC paths. RAPI services can be exposed to Data
399-
API consumers without rewriting or duplicating service logic.
398+
as REST endpoints alongside their JSON-RPC paths. Existing JSON-RPC services can be
399+
exposed to REST and MCP consumers without rewriting or duplicating service logic.
400400

401401
### Dependency
402402
Phase 1 (starter registers both dispatchers), Phase 2 (REST paths appear in OpenAPI
@@ -574,7 +574,7 @@ understand the multi-protocol positioning, and have concrete migration guides.
574574
reference implementation in the distribution
575575
- README updated to reflect starter usage once Phase 1 ships
576576
577-
4. **Migration guide: RAPI JSON-RPC → Dual-Protocol**
577+
4. **Migration guide: JSON-RPC → Dual-Protocol**
578578
- Step-by-step: add `@RestMapping` annotations, enable REST dispatcher, verify
579579
both paths, update OpenAPI spec, expose MCP tools
580580
- Targets teams running Axis2 JSON-RPC who want REST and MCP without rewriting
@@ -608,7 +608,7 @@ Claude Desktop / AI agent → MCP (native transport, Phase 6)
608608
609609
Data API / React frontend → REST (Phase 3) ──► Axis2 Service
610610
↑ (one implementation)
611-
Existing RAPI callers → JSON-RPC (unchanged)
611+
Existing JSON-RPC callers → JSON-RPC (unchanged)
612612
```
613613
614614
With OpenAPI spec and MCP tool definitions auto-generated (Phase 2) and a Spring Boot

0 commit comments

Comments
 (0)