javax.xml.bind.attachment

---

1. Generating SOAP Messages with Attachments

import javax.xml.bind.annotation.*;
import javax.xml.bind.attachment.*;

@XmlRootElement(name = "Mail")
public class Mail {
    private String from;
    private String to;
    @XmlAttachmentRef
    private Attachment attachment;
}

2. Consuming SOAP Messages with Attachments

AttachmentPart part = attachment.getAttachmentParts().get(0);
part.getDataHandler().getInputStream(); // Read attachment content

3. Sending Attachments with SOAP Web Services

import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
import javax.xml.bind.annotation.*;
import javax.xml.bind.attachment.*;

@WebService
@SOAPBinding(parameterStyle = SOAPBinding.ParameterStyle.BARE)
public class AttachmentWebService {
    public void sendAttachment(@Param("mail") Mail mail) {
        // Save attachment
    }
}

4. Receiving Attachments with SOAP Web Services

import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
import javax.xml.bind.annotation.*;
import javax.xml.bind.attachment.*;

@WebService
@SOAPBinding(parameterStyle = SOAPBinding.ParameterStyle.BARE)
public class AttachmentWebService {
    @WebMethod(operationName = "getAttachment")
    public Mail getAttachment() {
        // Prepare mail object with attachment
        return mail;
    }
}

5. Using @XmlAttachmentRef Annotation

@XmlAttachmentRef(value = "/myAttachment")
private Attachment attachment;

6. Using AttachmentMarshaller

AttachmentMarshaller marshaller = ctx.createAttachmentMarshaller();
marshaller.marshall(attachment);

7. Using AttachmentUnmarshaller

AttachmentUnmarshaller unmarshaller = ctx.createAttachmentUnmarshaller();
Attachment attachment = unmarshaller.unmarshal(part);

8. Creating Attachment

AttachmentBuilder builder = ctx.createAttachmentBuilder();
builder.addContent(DataHandler);
Attachment attachment = builder.build();

9. Using MTOM Policy

<soap:binding use="literal" transport="http://schemas.xmlsoap.org/soap/http" />

<soap12:policy>
  <soap12:messageTransmissionOptimization>
    <soap12:enabled>true</soap12:enabled>
  </soap12:messageTransmissionOptimization>
</soap12:policy>

10. Using SOAP with Attachments (MTOM)

SOAPConnectionFactory factory = SOAPConnectionFactory.newInstance();
SOAPConnection connection = factory.createConnection();
SOAPMessage request = MessageFactory.newInstance().createMessage();

11. Using SOAP with Attachments (SWA)

SOAPConnectionFactory factory = SOAPConnectionFactory.newInstance();
SOAPConnection connection = factory.createConnection();
SOAPMessage request = MessageFactory.newInstance().createMessage();

12. Using Attachment Type

public enum AttachmentType {
    TEXT_PLAIN,
    TEXT_HTML,
    IMAGE_JPG,
    IMAGE_PNG
}

13. Using MimeHeaders

import java.util.HashMap;
import java.util.Map;

public class MimeHeaders {
    private Map<String, String> headers = new HashMap<>();
}

14. Using DataHandler

import javax.activation.DataHandler;

public class DataHandler {
    private Object content;
    private MimeType contentType;
}

15. Using MimeType

import javax.activation.MimeType;

public class MimeType {
    private String type;
    private String subtype;
}

16. Using JAXBContext

JAXBContext context = JAXBContext.newInstance(Mail.class);
Marshaller marshaller = context.createMarshaller();
marshaller.marshal(mail, System.out);

17. Using Unmarshaller

JAXBContext context = JAXBContext.newInstance(Mail.class);
Unmarshaller unmarshaller = context.createUnmarshaller();
Mail mail = unmarshaller.unmarshal(inputStream);

18. Using @XmlRootElement Annotation

@XmlRootElement(name = "Mail", namespace = "http://example.org")
public class Mail {
    private String from;
    private String to;
}

19. Using @XmlElement Annotation

@XmlElement(name = "from")
public String getFrom() {
    return from;
}

@XmlElement(name = "to")
public String getTo() {
    return to;
}

20. Using @XmlAttribute Annotation

@XmlAttribute(name = "id")
private String id;

21. Using @XmlTransient Annotation

@XmlTransient
private Attachment attachment;

22. Using @XmlAccessorOrder Annotation

@XmlAccessorOrder(XmlAccessOrder.ALPHABETICAL)
public class Mail {
    private String from;
    private String to;
}

23. Using @XmlElementRef Annotation

@XmlElementRef
private Attachment attachment;

24. Using @XmlElementWrapper Annotation

@XmlElementWrapper(name = "attachments")
private Attachment[] attachments;

25. Using @XmlAnyElement Annotation

@XmlAnyElement
private List<Element> anyElement;

26. Using @XmlSchema Annotation**

@XmlSchema(elementFormDefault = XmlNsForm.QUALIFIED)
public class AttachmentWebService {
    // ...
}

27. Using @XmlJavaTypeAdapter Annotation**

@XmlJavaTypeAdapter(MailAdapter.class)
private Mail mail;

28. Using @XmlInlineBinaryData Annotation**

@XmlInlineBinaryData
private byte[] data;

29. Using @XmlID Annotation

@XmlID
private String id;

30. Using @XmlIDREF Annotation

@XmlIDREF
private Attachment attachment;

31. Using @XmlList Annotation

@XmlList
private List<String> values;

32. Using @XmlName Annotation

@XmlName("mail")
public class Mail {
    // ...
}

33. Using @XmlNamespace Annotation

@XmlNamespace(prefix = "mail", namespaceURI = "http://example.org")
public class Mail {
    // ...
}

34. Using @XmlPath Annotation

@XmlPath("attachments/attachment[1]")
private Attachment firstAttachment;

35. Using @XmlProperty Annotation

@XmlProperty(name = "mail")
public Mail getMail() {
    return mail;
}

36. Using @XmlRegistry Annotation

@XmlRegistry
public class ObjectFactory {
    // ...
}

37. Using @XmlRootElementWrapper Annotation

@XmlRootElementWrapper(name = "mails")
private List<Mail> mails;

38. Using @XmlSchemaType Annotation

@XmlSchemaType(name = "email")
private String email;

39. Using @XmlSeeAlso Annotation

@XmlSeeAlso({Mail.class, Attachment.class})
public class MailWebService {
    // ...
}

40. Using @XmlEnumValue Annotation

public enum Status {
    @XmlEnumValue("new")
    NEW,
    @XmlEnumValue("in_progress")
    IN_PROGRESS,
    @XmlEnumValue("completed")
    COMPLETED
}

41. Using @XmlMixed Annotation

@XmlMixed
private List<String> values;

42. Using @XmlTransient Annotation

@XmlTransient
private Attachment attachment;

43. Using @XmlValue Annotation

@XmlValue
private String value;

44. Using @XmlWrapperType Annotation

@XmlWrapperType(name = "attachments")
private Attachment[] attachments;

45. Using @XmlAnyElement Annotation

@XmlAnyElement
private List<Element> anyElement;

46. Using @XmlAttachmentRef Annotation

@XmlAttachmentRef
private Attachment attachment;

47. Using @XmlElement Annotation

@XmlElement(name = "from")
public String getFrom() {
    return from;
}

48. Using @XmlElements Annotation

@XmlElements({
    @XmlElement(name = "attachment", type = Attachment.class),
    @XmlElement(name = "mail", type = Mail.class)
})
private List<Object> objects;

49. Using @XmlElementWrapper Annotation

@XmlElementWrapper(name = "attachments")
private List<Attachment> attachments;

50. Using @XmlRootElement Annotation

@XmlRootElement(name = "Mail")
public class Mail {
    // ...
}