P_BleServerImpl

java.lang.Object
- com.idevicesinc.sweetblue.internal.P_BleServerImpl

All Implemented Interfaces:: IBleNode, IBleServer, UsesCustomNull

public final class P_BleServerImpl
extends java.lang.Object
implements IBleServer

Nested Class Summary
- Nested classes/interfaces inherited from interface com.idevicesinc.sweetblue.internal.IBleServer
  IBleServer.DefaultFactory, IBleServer.Factory

Field Summary

Fields
Modifier and Type Field and Description

static P_BleServerImpl NULL
Special value that is used in place of Java's built-in null.
- Fields inherited from interface com.idevicesinc.sweetblue.internal.IBleServer
  DEFAULT_FACTORY

Fields
Modifier and Type	Field and Description
`static P_BleServerImpl`	`NULL` Special value that is used in place of Java's built-in `null`.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`AddServiceListener.ServiceAddEvent`	`addService(BleService service, AddServiceListener listener)` Starts the process of adding a service to this server.
`<T extends com.idevicesinc.sweetblue.internal.BleNodeImpl> T`	`cast()` Just some sugar for casting to subclasses.
`<T extends com.idevicesinc.sweetblue.internal.BleNodeImpl> T`	`cast(java.lang.Class<T> type)` Safer version of `cast()` that will return `BleDevice.NULL` or `BleServer.NULL` if the cast cannot be made.
`void`	`clearListeners()`
`BleManagerConfig`	`conf_mngr()`
`BleNodeConfig`	`conf_node()`
`ServerReconnectFilter.ConnectFailEvent`	`connect_internal(P_DeviceHolder nativeDevice, boolean isRetrying)`
`ServerReconnectFilter.ConnectFailEvent`	`connect(java.lang.String macAddress, ServerConnectListener connectListener, ServerReconnectFilter connectionFailListener)` Connect to the given client mac address and provided listeners that are shorthand for calling `setListener_State(ServerStateListener)` `setListener_ReconnectFilter(ServerReconnectFilter)`.
`void`	`disconnect_internal(AddServiceListener.Status status_serviceAdd, ServerReconnectFilter.Status status_connectionFail, State.ChangeIntent intent)`
`void`	`disconnect()`
`boolean`	`disconnect(java.lang.String macAddress)`
`boolean`	`equals(IBleServer server_nullable)` Does a referential equality check on the two servers.
`boolean`	`equals(java.lang.Object object_nullable)` Returns `equals(IBleServer)` if object is an instance of `BleServer`.
`BleServer`	`getBleServer()`
`int`	`getClientCount()` Returns the total number of clients this server is connecting or connected to (or previously so).
`int`	`getClientCount(BleServerState... states)` Returns the number of clients that are in any of the given states.
`int`	`getClientCount(BleServerState state)` Returns the number of clients that are in the current state.
`java.util.List<java.lang.String>`	`getClients_List()` Overload of `getClients()` that returns a `List` for you.
`java.util.List<java.lang.String>`	`getClients_List(BleServerState... states)` Overload of `getClients(BleServerState[])` that returns a `List` for you.
`java.util.List<java.lang.String>`	`getClients_List(BleServerState state)` Overload of `getClients(BleServerState)` that returns a `List` for you.
`java.util.Iterator<java.lang.String>`	`getClients()` Returns all the clients connected or connecting (or previously so) to this server.
`java.util.Iterator<java.lang.String>`	`getClients(BleServerState... states)` Returns all the clients connected or connecting (or previously so) to this server.
`java.util.Iterator<java.lang.String>`	`getClients(BleServerState state)` Returns all the clients connected or connecting (or previously so) to this server.
`void`	`getClients(ForEach_Breakable<java.lang.String> forEach)` Overload of `getClients(ForEach_Void)` if you need to break out of the iteration at any point.
`void`	`getClients(ForEach_Breakable<java.lang.String> forEach, BleServerState... states)` Same as `getClients(ForEach_Breakable)` but will only return clients in any of the given states provided.
`void`	`getClients(ForEach_Breakable<java.lang.String> forEach, BleServerState state)` Overload of `getClients(ForEach_Void, BleServerState)` if you need to break out of the iteration at any point.
`void`	`getClients(ForEach_Void<java.lang.String> forEach)` Offers a more "functional" means of iterating through the internal list of clients instead of using `getClients()` or `getClients_List()`.
`void`	`getClients(ForEach_Void<java.lang.String> forEach, BleServerState... states)` Same as `getClients(ForEach_Void)` but will only return clients in any of the given states provided.
`void`	`getClients(ForEach_Void<java.lang.String> forEach, BleServerState state)` Same as `getClients(ForEach_Void)` but will only return clients in the given state provided.
`IBleManager`	`getIManager()` Returns this endpoint's manager.
`IServerListener`	`getInternalListener()`
`AdvertisingListener`	`getListener_Advertise()`
`IncomingListener`	`getListener_Incoming()` Returns the listener provided to `setListener_Incoming(IncomingListener)`.
`java.lang.String`	`getMacAddress()` Returns the local mac address provided by `BluetoothAdapter.getAddress()`.
`java.lang.String`	`getName()` Returns the name this `BleServer` is using (and will be advertised as, if applicable).
`android.bluetooth.BluetoothGattServer`	`getNative()` Provides just-in-case lower-level access to the native server instance.
`BleCharacteristic`	`getNativeBleCharacteristic(java.util.UUID serviceUuid, java.util.UUID charUuid)` Returns the native characteristic for the given UUID for when you have characteristics with identical uuids under different services.
`BleCharacteristic`	`getNativeBleCharacteristic(java.util.UUID serviceUuid, java.util.UUID charUuid, DescriptorFilter descriptorFilter)`
`BleDescriptor`	`getNativeBleDescriptor(java.util.UUID serviceUuid, java.util.UUID charUuid, java.util.UUID descUuid)` Returns the `BleDescriptor` for the given UUID in case you need lower-level access.
`BleService`	`getNativeBleService(java.util.UUID serviceUuid)` Returns the native service for the given UUID in case you need lower-level access.
`java.util.List<BleCharacteristic>`	`getNativeCharacteristics_List(java.util.UUID serviceUuid)` Convenience overload of `getNativeCharacteristics(UUID)` that returns a `List`.
`java.util.Iterator<BleCharacteristic>`	`getNativeCharacteristics(java.util.UUID serviceUuid)` Same as `getNativeCharacteristics(UUID)` but you can filter on the service `UUID`.
`void`	`getNativeCharacteristics(java.util.UUID serviceUuid, ForEach_Breakable<BleCharacteristic> forEach)` Overload of `getNativeCharacteristics(UUID)` that uses a for each construct instead of returning an iterator.
`void`	`getNativeCharacteristics(java.util.UUID serviceUuid, ForEach_Void<BleCharacteristic> forEach)` Overload of `getNativeCharacteristics(UUID)` that uses a for each construct instead of returning an iterator.
`java.util.List<BleDescriptor>`	`getNativeDescriptors_List(java.util.UUID serviceUuid, java.util.UUID charUuid)` Returns all descriptors on this node in the given characteristic as a list.
`java.util.Iterator<BleDescriptor>`	`getNativeDescriptors(java.util.UUID serviceUuid, java.util.UUID charUuid)` Returns all descriptors on this node in the given characteristic.
`void`	`getNativeDescriptors(java.util.UUID serviceUuid, java.util.UUID charUuid, ForEach_Breakable<BleDescriptor> forEach)` Overload of `BleNode.getNativeDescriptors(UUID, UUID)` using a for each construct.
`void`	`getNativeDescriptors(java.util.UUID serviceUuid, java.util.UUID charUuid, ForEach_Void<BleDescriptor> forEach)` Overload of `BleNode.getNativeDescriptors(UUID, UUID)` using a for each construct.
`IBluetoothServer`	`getNativeLayer()` Provides just-in-case access to the abstracted server instance.
`com.idevicesinc.sweetblue.internal.P_BleServerNativeManager`	`getNativeManager()`
`java.util.List<BleService>`	`getNativeServices_List()` Convenience overload of `getNativeServices()` that returns a `List`.
`java.util.Iterator<BleService>`	`getNativeServices()` Returns all `BluetoothGattService` instances.
`void`	`getNativeServices(ForEach_Breakable<BleService> forEach)` Overload of `getNativeServices()` that uses a for each construct instead of returning an iterator.
`void`	`getNativeServices(ForEach_Void<BleService> forEach)` Overload of `getNativeServices()` that uses a for each construct instead of returning an iterator.
`com.idevicesinc.sweetblue.internal.P_ServerServiceManager`	`getServerServiceManager()`
`<T extends com.idevicesinc.sweetblue.internal.PA_ServiceManager> T`	`getServiceManager()`
`int`	`getStateMask(java.lang.String macAddress)` Returns the bitwise state mask representation of `BleServerState` for the given client mac address.
`void`	`invokeConnectListeners(ServerConnectListener.ConnectEvent event)`
`void`	`invokeOutgoingListeners(OutgoingListener.OutgoingEvent e, OutgoingListener listener_specific_nullable)`
`boolean`	`is(java.lang.String macAddress, BleServerState state)` Returns true if the given client is in the state provided.
`boolean`	`isAdvertising()` Checks to see if the device is currently advertising.
`boolean`	`isAdvertising(java.util.UUID serviceUuid)` Checks to see if the device is currently advertising the given `UUID`.
`boolean`	`isAdvertisingSupported()` Checks to see if the device supports advertising BLE services.
`boolean`	`isAdvertisingSupportedByAndroidVersion()`
`boolean`	`isAdvertisingSupportedByChipset()` Checks to see if the device supports advertising.
`boolean`	`isAll(java.lang.String macAddress, int mask_BleServerState)` Returns `true` if there is complete bitwise overlap between the provided value and `getStateMask(String)`.
`boolean`	`isAny(java.lang.String macAddress, BleServerState... states)` Returns true if the given client is in any of the states provided.
`boolean`	`isAny(java.lang.String macAddress, int mask_BleServerState)` Returns `true` if there is any bitwise overlap between the provided value and `getStateMask(String)`.
`boolean`	`isNull()` Returns `true` if the object's state represents what would otherwise be Java's built-in `null`.
`P_Logger`	`logger()`
`HistoricalData`	`newHistoricalData(byte[] data, EpochTime epochTime)` Returns a new `HistoricalData` instance using `BleNodeConfig.historicalDataFactory` if available.
`void`	`onAdvertiseStarted(BleScanRecord packet, AdvertisingListener listener)`
`void`	`onAdvertiseStartFailed(AdvertisingListener.Status status, AdvertisingListener listener)`
`void`	`onNativeConnect(java.lang.String macAddress, boolean explicit)`
`void`	`onNativeConnectFail(P_DeviceHolder nativeDevice, ServerReconnectFilter.Status status, int gattStatus)`
`void`	`onNativeConnecting_implicit(java.lang.String macAddress)`
`void`	`onNativeDisconnect(java.lang.String macAddress, boolean explicit, int gattStatus)`
`HistoricalDataQueryListener.HistoricalDataQueryEvent`	`queryHistoricalData(java.lang.String query)`
`void`	`queryHistoricalData(java.lang.String query, HistoricalDataQueryListener listener)` Same as `queryHistoricalData(String)` but performs the query on a background thread and returns the result back on the main thread through the provided `HistoricalDataQueryListener`.
`void`	`removeAllServices()` Convenience to remove all services previously added with `addService(BleService, AddServiceListener)` (or overloads).
`BleService`	`removeService(java.util.UUID serviceUuid)`
`void`	`resetAdaptorName()`
`HistoricalDataQuery.Part_Select`	`select()` Provides a way to perform a statically checked SQL query by chaining method calls.
`OutgoingListener.OutgoingEvent`	`sendIndication(java.lang.String macAddress, java.util.UUID charUuid, byte[] data)` Overload of `sendIndication(String, UUID, UUID, FutureData, OutgoingListener)`.
`OutgoingListener.OutgoingEvent`	`sendIndication(java.lang.String macAddress, java.util.UUID charUuid, byte[] data, OutgoingListener listener)` Overload of `sendIndication(String, UUID, UUID, FutureData, OutgoingListener)`.
`OutgoingListener.OutgoingEvent`	`sendIndication(java.lang.String macAddress, java.util.UUID charUuid, FutureData futureData)` Overload of `sendIndication(String, UUID, UUID, FutureData, OutgoingListener)`.
`OutgoingListener.OutgoingEvent`	`sendIndication(java.lang.String macAddress, java.util.UUID charUuid, FutureData futureData, OutgoingListener listener)` Overload of `sendIndication(String, UUID, UUID, FutureData, OutgoingListener)`.
`OutgoingListener.OutgoingEvent`	`sendIndication(java.lang.String macAddress, java.util.UUID serviceUuid, java.util.UUID charUuid, byte[] data)` Overload of `sendIndication(String, UUID, UUID, FutureData, OutgoingListener)`.
`OutgoingListener.OutgoingEvent`	`sendIndication(java.lang.String macAddress, java.util.UUID serviceUuid, java.util.UUID charUuid, byte[] data, OutgoingListener listener)` Overload of `sendIndication(String, UUID, UUID, FutureData, OutgoingListener)`.
`OutgoingListener.OutgoingEvent`	`sendIndication(java.lang.String macAddress, java.util.UUID serviceUuid, java.util.UUID charUuid, FutureData futureData)` Overload of `sendIndication(String, UUID, UUID, FutureData, OutgoingListener)`.
`OutgoingListener.OutgoingEvent`	`sendIndication(java.lang.String macAddress, java.util.UUID serviceUuid, java.util.UUID charUuid, FutureData futureData, OutgoingListener listener)` Same as `sendNotification(String, UUID, UUID, FutureData, OutgoingListener)` but sends an indication instead.
`OutgoingListener.OutgoingEvent`	`sendNotification(java.lang.String macAddress, java.util.UUID charUuid, byte[] data)` Overload of `sendNotification(String, UUID, UUID, FutureData, OutgoingListener)`.
`OutgoingListener.OutgoingEvent`	`sendNotification(java.lang.String macAddress, java.util.UUID charUuid, byte[] data, OutgoingListener listener)` Overload of `sendNotification(String, UUID, UUID, FutureData, OutgoingListener)`.
`OutgoingListener.OutgoingEvent`	`sendNotification(java.lang.String macAddress, java.util.UUID charUuid, FutureData futureData)` Overload of `sendNotification(String, UUID, UUID, FutureData, OutgoingListener)`.
`OutgoingListener.OutgoingEvent`	`sendNotification(java.lang.String macAddress, java.util.UUID charUuid, FutureData futureData, OutgoingListener listener)` Overload of `sendNotification(String, UUID, UUID, FutureData, OutgoingListener)`.
`OutgoingListener.OutgoingEvent`	`sendNotification(java.lang.String macAddress, java.util.UUID serviceUuid, java.util.UUID charUuid, byte[] data)` Overload of `sendNotification(String, UUID, UUID, FutureData, OutgoingListener)`.
`OutgoingListener.OutgoingEvent`	`sendNotification(java.lang.String macAddress, java.util.UUID serviceUuid, java.util.UUID charUuid, byte[] data, OutgoingListener listener)` Overload of `sendNotification(String, UUID, UUID, FutureData, OutgoingListener)`.
`OutgoingListener.OutgoingEvent`	`sendNotification(java.lang.String macAddress, java.util.UUID serviceUuid, java.util.UUID charUuid, FutureData futureData)` Overload of `sendNotification(String, UUID, UUID, FutureData, OutgoingListener)`.
`OutgoingListener.OutgoingEvent`	`sendNotification(java.lang.String macAddress, java.util.UUID serviceUuid, java.util.UUID charUuid, FutureData futureData, OutgoingListener listener)`
`void`	`setConfig(BleNodeConfig config_nullable)` Optionally sets overrides for any custom options given to `BleManager.get(android.content.Context, BleManagerConfig)` for this individual server.
`void`	`setListener_Advertising(AdvertisingListener listener_nullable)`
`void`	`setListener_Connect(ServerConnectListener listener_nullable)` Set a listener here to be notified whenever this server's clients state changes eg.
`void`	`setListener_Incoming(IncomingListener listener_nullable)` Set a listener here to override any listener provided previously.
`void`	`setListener_Outgoing(OutgoingListener listener)`
`void`	`setListener_ReconnectFilter(ServerReconnectFilter listener)` Set a listener here to override any listener provided previously.
`void`	`setListener_ServiceAdd(AddServiceListener listener_nullable)` Set a listener here to override any listener provided previously and provide a default backup that will be called after any listener provided to `addService(BleService, AddServiceListener)`.
`void`	`setListener_State(ServerStateListener listener_nullable)` Set a listener here to be notified whenever this server's state changes in relation to a specific client.
`boolean`	`setName(java.lang.String name)` Set the name you wish this `BleServer` to be known as.
`AdvertisingListener.AdvertisingEvent`	`startAdvertising(BleScanRecord advertisePacket, BleAdvertisingSettings settings, AdvertisingListener listener)` Starts advertising serviceUuids with the information supplied in `BleScanRecord`.
`void`	`stopAdvertising()` Stops the server from advertising.
`com.idevicesinc.sweetblue.internal.P_TaskManager`	`taskManager()`
`java.lang.String`	`toString()` Pretty-prints the list of connecting or connected clients.

Methods inherited from class java.lang.Object
clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.idevicesinc.sweetblue.internal.IBleNode
conf_mngr, getIManager, getNativeBleCharacteristic, getNativeBleCharacteristic, getNativeBleDescriptor, getNativeBleService, getNativeCharacteristics_List, getNativeCharacteristics, getNativeCharacteristics, getNativeCharacteristics, getNativeDescriptors_List, getNativeDescriptors, getNativeDescriptors, getNativeDescriptors, getNativeServices_List, getNativeServices, getNativeServices, getNativeServices, newHistoricalData, queryHistoricalData, queryHistoricalData, select

Field Detail
- NULL
```
public static final P_BleServerImpl NULL
```
  Special value that is used in place of Java's built-in null.

Method Detail

conf_node
```
public BleNodeConfig conf_node()
```
Specified by:

conf_node in interface IBleNode

getNativeManager

public com.idevicesinc.sweetblue.internal.P_BleServerNativeManager getNativeManager()

setConfig
```
public final void setConfig(BleNodeConfig config_nullable)
```
Optionally sets overrides for any custom options given to BleManager.get(android.content.Context, BleManagerConfig) for this individual server.

setListener_State
```
public final void setListener_State(ServerStateListener listener_nullable)
```
Set a listener here to be notified whenever this server's state changes in relation to a specific client.

setListener_Connect
```
public final void setListener_Connect(ServerConnectListener listener_nullable)
```
Set a listener here to be notified whenever this server's clients state changes eg. disconnected, connecting, and connected

setListener_Incoming
```
public final void setListener_Incoming(IncomingListener listener_nullable)
```
Set a listener here to override any listener provided previously.

setListener_ServiceAdd
```
public final void setListener_ServiceAdd(AddServiceListener listener_nullable)
```
Set a listener here to override any listener provided previously and provide a default backup that will be called after any listener provided to addService(BleService, AddServiceListener).

setListener_Advertising

public final void setListener_Advertising(AdvertisingListener listener_nullable)

getListener_Advertise

public final AdvertisingListener getListener_Advertise()

getListener_Incoming
```
public final IncomingListener getListener_Incoming()
```
Returns the listener provided to setListener_Incoming(IncomingListener).

setListener_Outgoing

public final void setListener_Outgoing(OutgoingListener listener)

setListener_ReconnectFilter
```
public final void setListener_ReconnectFilter(ServerReconnectFilter listener)
```
Set a listener here to override any listener provided previously.

sendIndication

public final OutgoingListener.OutgoingEvent sendIndication(java.lang.String macAddress,
                                                           java.util.UUID charUuid,
                                                           byte[] data)

Overload of sendIndication(String, UUID, UUID, FutureData, OutgoingListener).

sendIndication

public final OutgoingListener.OutgoingEvent sendIndication(java.lang.String macAddress,
                                                           java.util.UUID charUuid,
                                                           byte[] data,
                                                           OutgoingListener listener)

Overload of sendIndication(String, UUID, UUID, FutureData, OutgoingListener).

sendIndication

public final OutgoingListener.OutgoingEvent sendIndication(java.lang.String macAddress,
                                                           java.util.UUID serviceUuid,
                                                           java.util.UUID charUuid,
                                                           byte[] data)

Overload of sendIndication(String, UUID, UUID, FutureData, OutgoingListener).

sendIndication

public final OutgoingListener.OutgoingEvent sendIndication(java.lang.String macAddress,
                                                           java.util.UUID serviceUuid,
                                                           java.util.UUID charUuid,
                                                           byte[] data,
                                                           OutgoingListener listener)

Overload of sendIndication(String, UUID, UUID, FutureData, OutgoingListener).

sendIndication

public final OutgoingListener.OutgoingEvent sendIndication(java.lang.String macAddress,
                                                           java.util.UUID charUuid,
                                                           FutureData futureData)

Overload of sendIndication(String, UUID, UUID, FutureData, OutgoingListener).

sendIndication

public final OutgoingListener.OutgoingEvent sendIndication(java.lang.String macAddress,
                                                           java.util.UUID charUuid,
                                                           FutureData futureData,
                                                           OutgoingListener listener)

Overload of sendIndication(String, UUID, UUID, FutureData, OutgoingListener).

sendIndication

public final OutgoingListener.OutgoingEvent sendIndication(java.lang.String macAddress,
                                                           java.util.UUID serviceUuid,
                                                           java.util.UUID charUuid,
                                                           FutureData futureData)

Overload of sendIndication(String, UUID, UUID, FutureData, OutgoingListener).

sendIndication

public final OutgoingListener.OutgoingEvent sendIndication(java.lang.String macAddress,
                                                           java.util.UUID serviceUuid,
                                                           java.util.UUID charUuid,
                                                           FutureData futureData,
                                                           OutgoingListener listener)

Same as sendNotification(String, UUID, UUID, FutureData, OutgoingListener) but sends an indication instead.

sendNotification

public final OutgoingListener.OutgoingEvent sendNotification(java.lang.String macAddress,
                                                             java.util.UUID charUuid,
                                                             byte[] data)

Overload of sendNotification(String, UUID, UUID, FutureData, OutgoingListener).

sendNotification

public final OutgoingListener.OutgoingEvent sendNotification(java.lang.String macAddress,
                                                             java.util.UUID charUuid,
                                                             byte[] data,
                                                             OutgoingListener listener)

Overload of sendNotification(String, UUID, UUID, FutureData, OutgoingListener).

sendNotification

public final OutgoingListener.OutgoingEvent sendNotification(java.lang.String macAddress,
                                                             java.util.UUID serviceUuid,
                                                             java.util.UUID charUuid,
                                                             byte[] data)

Overload of sendNotification(String, UUID, UUID, FutureData, OutgoingListener).

sendNotification

public final OutgoingListener.OutgoingEvent sendNotification(java.lang.String macAddress,
                                                             java.util.UUID serviceUuid,
                                                             java.util.UUID charUuid,
                                                             byte[] data,
                                                             OutgoingListener listener)

Overload of sendNotification(String, UUID, UUID, FutureData, OutgoingListener).

sendNotification

public final OutgoingListener.OutgoingEvent sendNotification(java.lang.String macAddress,
                                                             java.util.UUID charUuid,
                                                             FutureData futureData)

Overload of sendNotification(String, UUID, UUID, FutureData, OutgoingListener).

sendNotification

public final OutgoingListener.OutgoingEvent sendNotification(java.lang.String macAddress,
                                                             java.util.UUID charUuid,
                                                             FutureData futureData,
                                                             OutgoingListener listener)

Overload of sendNotification(String, UUID, UUID, FutureData, OutgoingListener).

sendNotification

public final OutgoingListener.OutgoingEvent sendNotification(java.lang.String macAddress,
                                                             java.util.UUID serviceUuid,
                                                             java.util.UUID charUuid,
                                                             FutureData futureData)

Overload of sendNotification(String, UUID, UUID, FutureData, OutgoingListener).

sendNotification

public final OutgoingListener.OutgoingEvent sendNotification(java.lang.String macAddress,
                                                             java.util.UUID serviceUuid,
                                                             java.util.UUID charUuid,
                                                             FutureData futureData,
                                                             OutgoingListener listener)

isAdvertisingSupportedByAndroidVersion

public final boolean isAdvertisingSupportedByAndroidVersion()

isAdvertisingSupportedByChipset
```
public final boolean isAdvertisingSupportedByChipset()
```
Checks to see if the device supports advertising. This is forwarded from BleManager.isAdvertisingSupportedByChipset().

isAdvertisingSupported
```
public final boolean isAdvertisingSupported()
```
Checks to see if the device supports advertising BLE services. This is forwarded from BleManager.isAdvertisingSupported().

isAdvertising
```
public final boolean isAdvertising()
```
Checks to see if the device is currently advertising.

isAdvertising
```
public final boolean isAdvertising(java.util.UUID serviceUuid)
```
Checks to see if the device is currently advertising the given UUID.

startAdvertising

public final AdvertisingListener.AdvertisingEvent startAdvertising(BleScanRecord advertisePacket,
                                                                   BleAdvertisingSettings settings,
                                                                   AdvertisingListener listener)

Starts advertising serviceUuids with the information supplied in BleScanRecord. Note that this will only work for devices on Lollipop, or above. Even then, not every device supports advertising. Use BleManager.isAdvertisingSupported() to check to see if the phone supports it.

stopAdvertising
```
public final void stopAdvertising()
```
Stops the server from advertising.

getName
```
public final java.lang.String getName()
```
Returns the name this BleServer is using (and will be advertised as, if applicable).

setName
```
public final boolean setName(java.lang.String name)
```
Set the name you wish this BleServer to be known as. This will affect how other devices see this server, and sets the name on the lower level BluetoothAdapter. If you DO change this, please be aware this will affect everything, including apps outside of your own. It's probably best NOT to use this, but it's here for flexibility.

Returns:

true if the name was successfully set. This can return false if BLE is turned off -- so the underlying BluetoothAdapter is null.

resetAdaptorName
```
public final void resetAdaptorName()
```

getNative
```
public final android.bluetooth.BluetoothGattServer getNative()
```
Provides just-in-case lower-level access to the native server instance. See similar warning for BleDevice.getNative().

getNativeLayer
```
public final IBluetoothServer getNativeLayer()
```
Provides just-in-case access to the abstracted server instance. See similar warning for BleDevice.getNative().

getStateMask
```
public final int getStateMask(java.lang.String macAddress)
```
Returns the bitwise state mask representation of BleServerState for the given client mac address.

See Also:

BleServerState

isAny
```
public final boolean isAny(java.lang.String macAddress,
                           int mask_BleServerState)
```
Returns true if there is any bitwise overlap between the provided value and getStateMask(String).

See Also:

isAll(String, int)

isAll
```
public final boolean isAll(java.lang.String macAddress,
                           int mask_BleServerState)
```
Returns true if there is complete bitwise overlap between the provided value and getStateMask(String).

See Also:

isAny(String, int)

is

public final boolean is(java.lang.String macAddress,
                        BleServerState state)

Returns true if the given client is in the state provided.

isAny

public final boolean isAny(java.lang.String macAddress,
                           BleServerState... states)

Returns true if the given client is in any of the states provided.

connect

public final ServerReconnectFilter.ConnectFailEvent connect(java.lang.String macAddress,
                                                            ServerConnectListener connectListener,
                                                            ServerReconnectFilter connectionFailListener)

Connect to the given client mac address and provided listeners that are shorthand for calling setListener_State(ServerStateListener) setListener_ReconnectFilter(ServerReconnectFilter).

disconnect

public final boolean disconnect(java.lang.String macAddress)

disconnect
```
public final void disconnect()
```

isNull
```
public final boolean isNull()
```
Description copied from interface: UsesCustomNull

Returns true if the object's state represents what would otherwise be Java's built-in null.

Specified by:

isNull in interface UsesCustomNull

equals

public final boolean equals(IBleServer server_nullable)

Does a referential equality check on the two servers.

equals
```
public final boolean equals(java.lang.Object object_nullable)
```
Returns equals(IBleServer) if object is an instance of BleServer. Otherwise calls super.

Overrides:

equals in class java.lang.Object

addService

public final AddServiceListener.ServiceAddEvent addService(BleService service,
                                                           AddServiceListener listener)

Starts the process of adding a service to this server. The provided listener will be called when the service is added or there is a problem.

removeService

public final BleService removeService(java.util.UUID serviceUuid)

removeAllServices
```
public final void removeAllServices()
```
Convenience to remove all services previously added with addService(BleService, AddServiceListener) (or overloads). This is slightly more performant too.

getClients
```
public final void getClients(ForEach_Void<java.lang.String> forEach)
```
Offers a more "functional" means of iterating through the internal list of clients instead of using getClients() or getClients_List().

getClients

public final void getClients(ForEach_Void<java.lang.String> forEach,
                             BleServerState state)

Same as getClients(ForEach_Void) but will only return clients in the given state provided.

getClients

public final void getClients(ForEach_Void<java.lang.String> forEach,
                             BleServerState... states)

Same as getClients(ForEach_Void) but will only return clients in any of the given states provided.

getClients
```
public final void getClients(ForEach_Breakable<java.lang.String> forEach)
```
Overload of getClients(ForEach_Void) if you need to break out of the iteration at any point.

getClients

public final void getClients(ForEach_Breakable<java.lang.String> forEach,
                             BleServerState state)

Overload of getClients(ForEach_Void, BleServerState) if you need to break out of the iteration at any point.

getClients

public final void getClients(ForEach_Breakable<java.lang.String> forEach,
                             BleServerState... states)

Same as getClients(ForEach_Breakable) but will only return clients in any of the given states provided.

getClients
```
public final java.util.Iterator<java.lang.String> getClients()
```
Returns all the clients connected or connecting (or previously so) to this server.

getClients
```
public final java.util.Iterator<java.lang.String> getClients(BleServerState state)
```
Returns all the clients connected or connecting (or previously so) to this server.

getClients
```
public final java.util.Iterator<java.lang.String> getClients(BleServerState... states)
```
Returns all the clients connected or connecting (or previously so) to this server.

getClients_List

public final java.util.List<java.lang.String> getClients_List()

Overload of getClients() that returns a List for you.

getClients_List

public final java.util.List<java.lang.String> getClients_List(BleServerState state)

Overload of getClients(BleServerState) that returns a List for you.

getClients_List

public final java.util.List<java.lang.String> getClients_List(BleServerState... states)

Overload of getClients(BleServerState[]) that returns a List for you.

getClientCount
```
public final int getClientCount()
```
Returns the total number of clients this server is connecting or connected to (or previously so).

getClientCount
```
public final int getClientCount(BleServerState state)
```
Returns the number of clients that are in the current state.

getClientCount
```
public final int getClientCount(BleServerState... states)
```
Returns the number of clients that are in any of the given states.

toString
```
public final java.lang.String toString()
```
Pretty-prints the list of connecting or connected clients.

Overrides:

toString in class java.lang.Object

getMacAddress
```
public final java.lang.String getMacAddress()
```
Returns the local mac address provided by BluetoothAdapter.getAddress().

onAdvertiseStarted

public final void onAdvertiseStarted(BleScanRecord packet,
                                     AdvertisingListener listener)

onAdvertiseStartFailed

public final void onAdvertiseStartFailed(AdvertisingListener.Status status,
                                         AdvertisingListener listener)

disconnect_internal

public final void disconnect_internal(AddServiceListener.Status status_serviceAdd,
                                      ServerReconnectFilter.Status status_connectionFail,
                                      State.ChangeIntent intent)

getBleServer
```
public BleServer getBleServer()
```

onNativeConnectFail

public final void onNativeConnectFail(P_DeviceHolder nativeDevice,
                                      ServerReconnectFilter.Status status,
                                      int gattStatus)

onNativeDisconnect

public final void onNativeDisconnect(java.lang.String macAddress,
                                     boolean explicit,
                                     int gattStatus)

onNativeConnect

public final void onNativeConnect(java.lang.String macAddress,
                                  boolean explicit)

onNativeConnecting_implicit

public final void onNativeConnecting_implicit(java.lang.String macAddress)

getServerServiceManager

public com.idevicesinc.sweetblue.internal.P_ServerServiceManager getServerServiceManager()

invokeOutgoingListeners

public final void invokeOutgoingListeners(OutgoingListener.OutgoingEvent e,
                                          OutgoingListener listener_specific_nullable)

invokeConnectListeners

public final void invokeConnectListeners(ServerConnectListener.ConnectEvent event)

connect_internal

public final ServerReconnectFilter.ConnectFailEvent connect_internal(P_DeviceHolder nativeDevice,
                                                                     boolean isRetrying)

getInternalListener

public final IServerListener getInternalListener()

clearListeners
```
public final void clearListeners()
```

getServiceManager

public <T extends com.idevicesinc.sweetblue.internal.PA_ServiceManager> T getServiceManager()

getNativeBleDescriptor
```
public BleDescriptor getNativeBleDescriptor(java.util.UUID serviceUuid,
                                            java.util.UUID charUuid,
                                            java.util.UUID descUuid)
```
Returns the BleDescriptor for the given UUID in case you need lower-level access. Note that this will never return a null instance. You need to call P_NativeGattObject.isNull() to check if the BluetoothGattDescriptor actually exists (in other words, it will return true if we were unable to find the requested descriptor).

Specified by:

getNativeBleDescriptor in interface IBleNode

getNativeBleCharacteristic
```
public BleCharacteristic getNativeBleCharacteristic(java.util.UUID serviceUuid,
                                                    java.util.UUID charUuid)
```
Returns the native characteristic for the given UUID for when you have characteristics with identical uuids under different services. Note that this will never return a null instance. You need to call P_NativeGattObject.isNull() to check if the BluetoothGattCharacteristic actually exists (in other words, it will return true if we were unable to find the requested characteristic).

Specified by:

getNativeBleCharacteristic in interface IBleNode

getNativeBleCharacteristic

public BleCharacteristic getNativeBleCharacteristic(java.util.UUID serviceUuid,
                                                    java.util.UUID charUuid,
                                                    DescriptorFilter descriptorFilter)

Specified by:: getNativeBleCharacteristic in interface IBleNode

getNativeBleService
```
public BleService getNativeBleService(java.util.UUID serviceUuid)
```
Returns the native service for the given UUID in case you need lower-level access. Note that this will never return a null instance. You need to call P_NativeGattObject.isNull() to check if the BluetoothGattService actually exists (in other words, it will return true if we were unable to find the requested service).

Specified by:

getNativeBleService in interface IBleNode

getNativeServices
```
public java.util.Iterator<BleService> getNativeServices()
```
Returns all BluetoothGattService instances.

Specified by:

getNativeServices in interface IBleNode

getNativeServices_List
```
public java.util.List<BleService> getNativeServices_List()
```
Convenience overload of getNativeServices() that returns a List.

Specified by:

getNativeServices_List in interface IBleNode

getNativeServices
```
public void getNativeServices(ForEach_Void<BleService> forEach)
```
Overload of getNativeServices() that uses a for each construct instead of returning an iterator.

Specified by:

getNativeServices in interface IBleNode

getNativeServices
```
public void getNativeServices(ForEach_Breakable<BleService> forEach)
```
Overload of getNativeServices() that uses a for each construct instead of returning an iterator.

Specified by:

getNativeServices in interface IBleNode

getNativeCharacteristics
```
public void getNativeCharacteristics(java.util.UUID serviceUuid,
                                     ForEach_Void<BleCharacteristic> forEach)
```
Overload of getNativeCharacteristics(UUID) that uses a for each construct instead of returning an iterator.

Specified by:

getNativeCharacteristics in interface IBleNode

getNativeCharacteristics

public void getNativeCharacteristics(java.util.UUID serviceUuid,
                                     ForEach_Breakable<BleCharacteristic> forEach)

Overload of getNativeCharacteristics(UUID) that uses a for each construct instead of returning an iterator.

Specified by:: getNativeCharacteristics in interface IBleNode

getNativeCharacteristics
```
public java.util.Iterator<BleCharacteristic> getNativeCharacteristics(java.util.UUID serviceUuid)
```
Same as getNativeCharacteristics(UUID) but you can filter on the service UUID.

Specified by:

getNativeCharacteristics in interface IBleNode

getNativeCharacteristics_List
```
public java.util.List<BleCharacteristic> getNativeCharacteristics_List(java.util.UUID serviceUuid)
```
Convenience overload of getNativeCharacteristics(UUID) that returns a List.

Specified by:

getNativeCharacteristics_List in interface IBleNode

getNativeDescriptors

public java.util.Iterator<BleDescriptor> getNativeDescriptors(java.util.UUID serviceUuid,
                                                              java.util.UUID charUuid)

Returns all descriptors on this node in the given characteristic.

Specified by:: getNativeDescriptors in interface IBleNode

getNativeDescriptors_List

public java.util.List<BleDescriptor> getNativeDescriptors_List(java.util.UUID serviceUuid,
                                                               java.util.UUID charUuid)

Returns all descriptors on this node in the given characteristic as a list.

Specified by:: getNativeDescriptors_List in interface IBleNode

getNativeDescriptors

public void getNativeDescriptors(java.util.UUID serviceUuid,
                                 java.util.UUID charUuid,
                                 ForEach_Void<BleDescriptor> forEach)

Overload of BleNode.getNativeDescriptors(UUID, UUID) using a for each construct.

Specified by:: getNativeDescriptors in interface IBleNode

getNativeDescriptors

public void getNativeDescriptors(java.util.UUID serviceUuid,
                                 java.util.UUID charUuid,
                                 ForEach_Breakable<BleDescriptor> forEach)

Overload of BleNode.getNativeDescriptors(UUID, UUID) using a for each construct.

Specified by:: getNativeDescriptors in interface IBleNode

newHistoricalData

public HistoricalData newHistoricalData(byte[] data,
                                        EpochTime epochTime)

Returns a new HistoricalData instance using BleNodeConfig.historicalDataFactory if available.

Specified by:: newHistoricalData in interface IBleNode

getIManager
```
public IBleManager getIManager()
```
Returns this endpoint's manager.

Specified by:

getIManager in interface IBleNode

conf_mngr
```
public BleManagerConfig conf_mngr()
```
Specified by:

conf_mngr in interface IBleNode

taskManager

public com.idevicesinc.sweetblue.internal.P_TaskManager taskManager()

logger
```
public P_Logger logger()
```

queryHistoricalData

public HistoricalDataQueryListener.HistoricalDataQueryEvent queryHistoricalData(java.lang.String query)

Specified by:: queryHistoricalData in interface IBleNode

queryHistoricalData
```
public void queryHistoricalData(java.lang.String query,
                                HistoricalDataQueryListener listener)
```
Same as queryHistoricalData(String) but performs the query on a background thread and returns the result back on the main thread through the provided HistoricalDataQueryListener.

Specified by:

queryHistoricalData in interface IBleNode

select
```
public HistoricalDataQuery.Part_Select select()
```
Provides a way to perform a statically checked SQL query by chaining method calls.

Specified by:

select in interface IBleNode

cast

public <T extends com.idevicesinc.sweetblue.internal.BleNodeImpl> T cast()

Just some sugar for casting to subclasses.

cast

public <T extends com.idevicesinc.sweetblue.internal.BleNodeImpl> T cast(java.lang.Class<T> type)

Safer version of cast() that will return BleDevice.NULL or BleServer.NULL if the cast cannot be made.

Class P_BleServerImpl

Nested Class Summary

Nested classes/interfaces inherited from interface com.idevicesinc.sweetblue.internal.IBleServer

Field Summary

Fields inherited from interface com.idevicesinc.sweetblue.internal.IBleServer

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface com.idevicesinc.sweetblue.internal.IBleNode

Field Detail

NULL

Method Detail

conf_node

getNativeManager

setConfig

setListener_State

setListener_Connect

setListener_Incoming

setListener_ServiceAdd

setListener_Advertising

getListener_Advertise

getListener_Incoming

setListener_Outgoing

setListener_ReconnectFilter

sendIndication

sendIndication

sendIndication

sendIndication

sendIndication

sendIndication

sendIndication

sendIndication

sendNotification

sendNotification

sendNotification

sendNotification

sendNotification

sendNotification

sendNotification

sendNotification

isAdvertisingSupportedByAndroidVersion

isAdvertisingSupportedByChipset

isAdvertisingSupported

isAdvertising

isAdvertising

startAdvertising

stopAdvertising

getName

setName

resetAdaptorName

getNative

getNativeLayer

getStateMask

isAny

isAll

is

isAny

connect

disconnect

disconnect

isNull

equals

equals

addService

removeService

removeAllServices

getClients

getClients

getClients

getClients

getClients

getClients

getClients

getClients

getClients

getClients_List

getClients_List

getClients_List

getClientCount

getClientCount

getClientCount