blob: 0343744373f716c840ccd13dd115c8956ae69f86 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
|
/*
* SIP Communicator, the OpenSource Java VoIP and Instant Messaging client.
*
* Distributable under LGPL license.
* See terms of license at gnu.org.
*/
package net.java.sip.communicator.plugin.msoutlook;
import net.java.sip.communicator.service.contactsource.*;
/**
* Implements <tt>ContactSourceService</tt> for the Address Book of Microsoft
* Outlook.
*
* @author Lyubomir Marinov
*/
public class MsOutlookAddressBookContactSourceService
implements ContactSourceService
{
private static final long MAPI_INIT_VERSION = 0;
private static final long MAPI_MULTITHREAD_NOTIFICATIONS = 0x00000001;
/**
* Initializes a new <tt>MsOutlookAddressBookContactSourceService</tt>
* instance.
*
* @throws MsOutlookMAPIHResultException if anything goes wrong while
* initializing the new <tt>MsOutlookAddressBookContactSourceService</tt>
* instance
*/
public MsOutlookAddressBookContactSourceService()
throws MsOutlookMAPIHResultException
{
MAPIInitialize(MAPI_INIT_VERSION, MAPI_MULTITHREAD_NOTIFICATIONS);
}
/**
* Gets a human-readable <tt>String</tt> which names this
* <tt>ContactSourceService</tt> implementation.
*
* @return a human-readable <tt>String</tt> which names this
* <tt>ContactSourceService</tt> implementation
* @see ContactSourceService#getDisplayName()
*/
public String getDisplayName()
{
return "Microsoft Outlook Address Book";
}
/**
* Gets a <tt>String</tt> which uniquely identifies the instances of the
* <tt>MsOutlookAddressBookContactSourceService</tt> implementation.
*
* @return a <tt>String</tt> which uniquely identifies the instances of the
* <tt>MsOutlookAddressBookContactSourceService</tt> implementation
* @see ContactSourceService#getIdentifier()
*/
public String getIdentifier()
{
return "MsOutlookAddressBook";
}
private static native void MAPIInitialize(long version, long flags)
throws MsOutlookMAPIHResultException;
private static native void MAPIUninitialize();
/**
* Queries this <tt>ContactSourceService</tt> for <tt>SourceContact</tt>s
* which match a specific <tt>query</tt> <tt>String</tt>.
*
* @param query the <tt>String</tt> which this <tt>ContactSourceService</tt>
* is being queried for
* @return a <tt>ContactQuery</tt> which represents the query of this
* <tt>ContactSourceService</tt> implementation for the specified
* <tt>String</tt> and via which the matching <tt>SourceContact</tt>s (if
* any) will be returned
* @see ContactSourceService#queryContactSource(String)
*/
public ContactQuery queryContactSource(String query)
{
// TODO Auto-generated method stub
return null;
}
/**
* Stops this <tt>ContactSourceService</tt> implementation and prepares it
* for garbage collection.
*/
void stop()
{
MAPIUninitialize();
}
}
|