1 /*
2 (C) Copyright IBM Corp. 2007, 2009
3
4 THIS FILE IS PROVIDED UNDER THE TERMS OF THE ECLIPSE PUBLIC LICENSE
5 ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION OF THIS FILE
6 CONSTITUTES RECIPIENTS ACCEPTANCE OF THE AGREEMENT.
7
8 You can obtain a current copy of the Eclipse Public License from
9 http://www.opensource.org/licenses/eclipse-1.0.php
10
11 @author : Alexander Wolf-Reber, IBM, a.wolf-reber@de.ibm.com
12 *
13 * Change History
14 * Flag Date Prog Description
15 *-------------------------------------------------------------------------------
16 * 1678915 2007-03-12 lupusalex Integrated WBEM service discovery via SLP
17 * 1729361 2007-06-04 lupusalex Multicast discovery is broken in DiscovererSLP
18 * 2003590 2008-06-30 blaschke-oss Change licensing from CPL to EPL
19 * 2524131 2009-01-21 raman_arora Upgrade client to JDK 1.5 (Phase 1)
20 */
21
22 package org.metricshub.wbem.sblim.cimclient.discovery;
23
24 /*-
25 * ╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲
26 * WBEM Java Client
27 * ჻჻჻჻჻჻
28 * Copyright 2023 - 2025 MetricsHub
29 * ჻჻჻჻჻჻
30 * Licensed under the Apache License, Version 2.0 (the "License");
31 * you may not use this file except in compliance with the License.
32 * You may obtain a copy of the License at
33 *
34 * http://www.apache.org/licenses/LICENSE-2.0
35 *
36 * Unless required by applicable law or agreed to in writing, software
37 * distributed under the License is distributed on an "AS IS" BASIS,
38 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
39 * See the License for the specific language governing permissions and
40 * limitations under the License.
41 * ╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱
42 */
43
44 /**
45 * Interface Discoverer offers methodology for discovering WBEM services.
46 *
47 * Implementations SHALL ensure thread-safety
48 * @since 2.0.2
49 */
50 public interface Discoverer {
51 /**
52 * Finds WBEM services using a given list of directory servers
53 *
54 * @param pDirectoryUrls
55 * An array of directory servers. For SLP this would be a list of
56 * DA URLs.
57 * @return The array of WBEM service advertisements found
58 */
59 public WBEMServiceAdvertisement[] findWbemServices(String[] pDirectoryUrls);
60
61 /**
62 * Finds directory services. The semantics of this method might be protocol
63 * specific. E.g. for SLP this sends a multicast into the local subnet
64 * looking first for directory agent, second for service agents.
65 *
66 * @return A String[] containing the URLs of the directories
67 * @since 2.0.3
68 */
69 public String[] findDirectoryServices();
70 }