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.controlpoint;
17  
18  import org.fourthline.cling.model.message.header.UpnpHeader;
19  import org.fourthline.cling.protocol.ProtocolFactory;
20  import org.fourthline.cling.UpnpServiceConfiguration;
21  import org.fourthline.cling.registry.Registry;
22  
23  import java.util.concurrent.Future;
24  
25  /**
26   * Unified API for the asynchronous execution of network searches, actions, event subscriptions.
27   *
28   * @author Christian Bauer
29   */
30  public interface ControlPoint {
31  
32      public UpnpServiceConfiguration getConfiguration();
33      public ProtocolFactory getProtocolFactory();
34      public Registry getRegistry();
35  
36      public void search();
37      public void search(UpnpHeader searchType);
38      public void search(int mxSeconds);
39      public void search(UpnpHeader searchType, int mxSeconds);
40      public Future execute(ActionCallback callback);
41      public void execute(SubscriptionCallback callback);
42  
43  }