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.Namespace;
19  import org.fourthline.cling.model.ValidationException;
20  import org.fourthline.cling.model.meta.Device;
21  import org.fourthline.cling.model.profile.RemoteClientInfo;
22  import org.w3c.dom.Document;
23  
24  /**
25   * Reads and generates device descriptor XML metadata.
26   *
27   * @author Christian Bauer
28   */
29  public interface DeviceDescriptorBinder {
30  
31      public <T extends Device> T describe(T undescribedDevice, String descriptorXml)
32              throws DescriptorBindingException, ValidationException;
33  
34      public <T extends Device> T describe(T undescribedDevice, Document dom)
35              throws DescriptorBindingException, ValidationException;
36  
37      public String generate(Device device, RemoteClientInfo info, Namespace namespace) throws DescriptorBindingException;
38  
39      public Document buildDOM(Device device, RemoteClientInfo info, Namespace namespace) throws DescriptorBindingException;
40  
41  }