net.smoofyuniverse.keyring.mac

Class KeychainKeyring

java.lang.Object

net.smoofyuniverse.keyring.mac.KeychainKeyring

All Implemented Interfaces:

Keyring

public class KeychainKeyring
extends java.lang.Object
implements Keyring

A keyring using MacOS Keychain. See https://developer.apple.com/documentation/security/keychain_services/keychain_items

Constructor Summary

Constructors

Constructor and Description
KeychainKeyring() Creates a new keyring using MacOS Keychain.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getBackendName() Gets the name of the backend.
java.lang.String	getPassword(java.lang.String service, java.lang.String account) Gets a password for the specified service and account.
void	setPassword(java.lang.String service, java.lang.String account, java.lang.String password) Sets a password for the specified service and account.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface net.smoofyuniverse.keyring.Keyring

create, validateAccount, validatePassword, validateService

Constructor Detail

KeychainKeyring

public KeychainKeyring()
                throws UnsupportedBackendException

Creates a new keyring using MacOS Keychain.

Throws:

UnsupportedBackendException - if the backend for this implementation is not available.

Method Detail

getBackendName

public java.lang.String getBackendName()

Description copied from interface: Keyring

Gets the name of the backend.

Specified by:

getBackendName in interface Keyring

Returns:

The name.

getPassword

public java.lang.String getPassword(java.lang.String service,
                                    java.lang.String account)
                             throws PasswordAccessException

Description copied from interface: Keyring

Gets a password for the specified service and account.

Specified by:

getPassword in interface Keyring

Parameters:

service - The service.

account - The account.

Returns:

The password or null if absent.

Throws:

PasswordAccessException - if any exception occurs while getting the password.

setPassword

public void setPassword(java.lang.String service,
                        java.lang.String account,
                        java.lang.String password)
                 throws PasswordAccessException

Description copied from interface: Keyring

Sets a password for the specified service and account.

Specified by:

setPassword in interface Keyring

Parameters:

service - The service.

account - The account.

password - The password or null to remove.

Throws:

PasswordAccessException - if any exception occurs while saving the password.