Kastor Guides
Version: Kastor RDF SDK
0.3.0-SNAPSHOT· Kotlin2.x· Java21+
This section contains task‑oriented guides for accomplishing specific outcomes. Each guide is scoped, reproducible, and includes prerequisites and expected outputs.
Terminology: RDF and Kastor terms (repository, dataset, SHACL shape, provider, …) are defined in the Glossary.
Diátaxis: these pages are how-to guides (task-first). Tutorials vs explanation vs reference — How documentation fits together (includes anti-patterns).
Available Guides
Best Practices
- Best Practices - Guidelines for effective Kastor usage
- Error Handling - Comprehensive guide to error handling and error codes
- Extending Kastor - How to extend Kastor with custom functionality
- Android & KMP Support - Platform-specific setup and ServiceLoader alternatives
How‑To Guides
- How to Create a Custom Vocabulary - Define typed vocabulary constants
- How to test RDF graphs - Golden Turtle, isomorphism assertions, and the
kastor-rdfCLI - How to Parse RDF - Load RDF data into graphs
- How to Serialize RDF - Export graphs to standard formats
- Typed SPARQL bindings & Flow -
getAs/getAsOrThrow, required columns, andFlowover results and parse streaming - JSON-LD Compaction and Framing - Understanding JSON-LD transformations and data preservation
- Debug Mode - Enable prefix expansion and query tracing for troubleshooting
- Performance Guide - Performance best practices and benchmarks
- How to Validate with SHACL - Validate data with shapes
- How to Create SHACL Shapes - Author shapes with the SHACL DSL
- How to Check Ontology Quality - OWL/SKOS quality catalogues, CLI, and semantic (embedding) tier
- How to Perform Reasoning - Run RDFS inference
- How to Use Datasets - Query across named graphs
- How to Work with Named Graphs - Manage datasets
- How to Use Transactions - Atomic write operations
- Migrating from 0.1.x to 0.2 (RDF 1.2) - Triple terms, LangString, AST, persistence notes
Tutorials and Examples
- Guides hub - Index of core workflow how-tos
- Cookbook - Practical examples and recipes
- Kastor Query DSL Tutorial - Deep dive into the query DSL
Support and Troubleshooting
- FAQ - Frequently asked questions
- Troubleshooting - Common issues and solutions
Guide Categories
For Beginners
- Start with Getting Started
- Follow Best Practices
- Check FAQ for common questions
For Intermediate Users
- Explore Cookbook for practical examples
- Learn Query DSL
- Understand Extending Kastor
For Advanced Users
- Master Best Practices
- Customize with Extending Kastor
- Troubleshoot with Troubleshooting