# Castor XML - HOW-TO's

## Introduction

This is a collection of HOW-TOs. The Castor project is actively seeking additional HOW-TO contributors to expand this collection. For information on how to do that, please see 'How to write a How-to'.

## Documentation

- How to Author a How-To (Author wanted!)

- How to Author an FAQ (Author wanted!)

- How to Author a Code Snippet (Author wanted!)

- How to Author Core Documentation (Author wanted!)

## Contribution

- How to submit an XML-specific bug report

- How to prepare a patch

- How to Contribute a Patch via Jira (Author wanted!)

- How to run Castor XML's test suite

## Mapping

- How to use XMLContext for un-/marshalling

- How to map a collection of elements

- How to map a map/hashtable of elements

- How to map a list of elements at the root

- How to map constructor arguments

- How to map an inner class

- How to Unmarshal raw XML segments into arbitrary types

- How to use references in XML and Castor

- How to wrap a collection with a wrapper element

- How to prevent a collection from being exposed

- How to write a configurable field handler

- How to map text content

- How to work with wrapper elements around collections

- How to work marshal XML documents with version 1.1

## Validation

- How to use XML validation

## Source generation

- How to use a binding file with source generation

## Others

- How to implement a custom serializer

- How to fetch DTDs and XML Schemas from JAR files

- How to marshal Hibernate proxies