View Javadoc
1   /*
2    * Copyright (C) 2013 4th Line GmbH, Switzerland
3    *
4    * The contents of this file are subject to the terms of either the GNU
5    * Lesser General Public License Version 2 or later ("LGPL") or the
6    * Common Development and Distribution License Version 1 or later
7    * ("CDDL") (collectively, the "License"). You may not use this file
8    * except in compliance with the License. See LICENSE.txt for more
9    * information.
10   *
11   * This program is distributed in the hope that it will be useful,
12   * but WITHOUT ANY WARRANTY; without even the implied warranty of
13   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
14   */
15  
16  package org.fourthline.cling.binding.xml;
17  
18  import org.fourthline.cling.model.ValidationException;
19  import org.fourthline.cling.model.meta.Service;
20  import org.w3c.dom.Document;
21  
22  /**
23   * Reads and generates service descriptor XML metadata.
24   *
25   * @author Christian Bauer
26   */
27  public interface ServiceDescriptorBinder {
28  
29      public <T extends Service> T describe(T undescribedService, String descriptorXml)
30              throws DescriptorBindingException, ValidationException;
31  
32      public <T extends Service> T describe(T undescribedService, Document dom)
33              throws DescriptorBindingException, ValidationException;
34  
35      public String generate(Service service) throws DescriptorBindingException;
36  
37      public Document buildDOM(Service service) throws DescriptorBindingException;
38  }