Package guru.interlis.convconf.api

Class ConvConfService

java.lang.Object

guru.interlis.convconf.api.ConvConfService

public final class ConvConfService
extends Object

Public façade for library users.

A conversion run follows three conceptual stages:

1. Compile KM and parse both LM files.
2. Validate semantic/data consistency and create a conversion plan.
3. Execute the plan through source/target adapters.

Constructor Summary

Constructors

Constructor	Description
ConvConfService()

Method Summary

Modifier and Type	Method	Description
List<String>	check(Path kmIli, Path lmFile)	Validates a single LM file against a KM model.
ConversionEngine.ConversionResult	convert(Path kmIli, Path sourceLm, Path targetLm, RecordSourceReader sourceReader, RecordTargetWriter targetWriter)	Full convert flow with trace collection disabled.
ConversionEngine.ConversionResult	convert(Path kmIli, Path sourceLm, Path targetLm, RecordSourceReader sourceReader, RecordTargetWriter targetWriter, boolean traceEnabled)	Full convert flow using LM paths (plan is built internally).
ConversionEngine.ConversionResult	convert(Path kmIli, Path sourceLm, Path targetLm, Connection source, Connection target)	Convenience overload that wraps JDBC connections with JdbcRecordAdapter.
ConversionEngine.ConversionResult	executePlan(Path kmIli, ConversionPlan plan, RecordSourceReader sourceReader, RecordTargetWriter targetWriter, boolean traceEnabled)	Executes a pre-built conversion plan.
ConversionPlan	plan(Path kmIli, Path sourceLm, Path targetLm)	Builds a validated conversion plan from KM + source LM + target LM.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ConvConfService

public ConvConfService()

Method Details

check

public List<String> check(Path kmIli,
 Path lmFile)
                   throws Exception

Validates a single LM file against a KM model.

Parameters:

kmIli - path to the INTERLIS KM model

lmFile - path to the LM definition to validate

Returns:

list of validation errors (empty if valid)

Throws:

Exception - if KM compile or LM parse fails

plan

public ConversionPlan plan(Path kmIli,
 Path sourceLm,
 Path targetLm)
                    throws Exception

Builds a validated conversion plan from KM + source LM + target LM.

Parameters:

kmIli - path to the INTERLIS KM model

sourceLm - path to source LM

targetLm - path to target LM

Returns:

plan including execution steps and parsed LM models

Throws:

Exception - if parsing/compilation fails or semantic checks fail

executePlan

public ConversionEngine.ConversionResult executePlan(Path kmIli,
 ConversionPlan plan,
 RecordSourceReader sourceReader,
 RecordTargetWriter targetWriter,
 boolean traceEnabled)
                                              throws Exception

Executes a pre-built conversion plan.

Parameters:

kmIli - path to KM model used for final result validation

plan - pre-built conversion plan

sourceReader - adapter used to read source records

targetWriter - adapter used to write target records

traceEnabled - if true, runtime trace events are collected

Returns:

conversion result with canonical records and optional trace events

Throws:

Exception - if read/write fails or validation fails

convert

public ConversionEngine.ConversionResult convert(Path kmIli,
 Path sourceLm,
 Path targetLm,
 RecordSourceReader sourceReader,
 RecordTargetWriter targetWriter,
 boolean traceEnabled)
                                          throws Exception

Full convert flow using LM paths (plan is built internally).

Throws:

Exception

convert

public ConversionEngine.ConversionResult convert(Path kmIli,
 Path sourceLm,
 Path targetLm,
 RecordSourceReader sourceReader,
 RecordTargetWriter targetWriter)
                                          throws Exception

Full convert flow with trace collection disabled.

Throws:

Exception

convert

public ConversionEngine.ConversionResult convert(Path kmIli,
 Path sourceLm,
 Path targetLm,
 Connection source,
 Connection target)
                                          throws Exception

Convenience overload that wraps JDBC connections with JdbcRecordAdapter.

Throws:

Exception