|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
ÀÌÀü Ŭ·¡½º ´ÙÀ½ Ŭ·¡½º | ÇÁ·¹ÀÓÀ¸·Î ÇÁ·¹ÀÓ ¾øÀÌ | |||||||||
°³¿ä: NESTED | Çʵå | constructor | ¸Þ¼µå | »ó¼¼: Çʵå | »ý¼ºÀÚ | ¸Þ¼µå |
java.lang.Objectjavax.naming.InitialContext
javax.naming.directory.InitialDirContext
public class InitialDirContext
ÀÌ Å¬·¡½º´Â µð·ºÅ丮 Á¶ÀÛÀ» ½ÇÇàÇϱâ À§ÇÑ °³½Ã ÄÁÅØ½ºÆ® ÀÔ´Ï´Ù. InitialContext Ŭ·¡½º¿¡ ´ëÇÑ ±â¼ú (µ¿±â ÄÁÅØ½ºÆ® À» Æ÷ÇÔÇÑ´Ù)ÀÌ Àû¿ëµË´Ï´Ù.
InitialContext
ÇÊµå °³¿ä |
---|
Ŭ·¡½º javax.naming. InitialContext ·ÎºÎÅÍ »ó¼ÓµÈ Çʵå |
---|
defaultInitCtx,
gotDefault,
myProps |
ÀÎÅÍÆäÀ̽º javax.naming.directory. DirContext ·ÎºÎÅÍ »ó¼ÓµÈ Çʵå |
---|
ADD_ATTRIBUTE,
REMOVE_ATTRIBUTE,
REPLACE_ATTRIBUTE |
ÀÎÅÍÆäÀ̽º javax.naming. Context ·ÎºÎÅÍ »ó¼ÓµÈ Çʵå |
---|
APPLET,
AUTHORITATIVE,
BATCHSIZE,
DNS_URL,
INITIAL_CONTEXT_FACTORY,
LANGUAGE,
OBJECT_FACTORIES,
PROVIDER_URL,
REFERRAL,
SECURITY_AUTHENTICATION,
SECURITY_CREDENTIALS,
SECURITY_PRINCIPAL,
SECURITY_PROTOCOL,
STATE_FACTORIES,
URL_PKG_PREFIXES |
»ý¼ºÀÚ °³¿ä | |
---|---|
|
InitialDirContext ()
Ãʱâ DirContext¸¦ ±¸ÃàÇÕ´Ï´Ù. |
protected |
InitialDirContext (boolean lazy)
ÃʱâÈÇÏÁö ¾Ê´Â´Ù°í ÇÏ´Â ¿É¼ÇÀ» °¡Áö´Â Ãʱâ DirContext¸¦ ±¸ÃàÇÕ´Ï´Ù. |
|
InitialDirContext (Hashtable <?,?> environment)
ÁöÁ¤ÇÑ È¯°æÀ» »ç¿ëÇØ Ãʱâ DirContext¸¦ ±¸ÃàÇÕ´Ï´Ù. |
¸Þ¼µå °³¿ä | |
---|---|
void |
bind (Name name,
Object obj,
Attributes attrs)
°ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø ¼Ó¼º°ú ÇÔ²², À̸§À» ¿ÀºêÁ§Æ®¿¡ ¹ÙÀεå ÇÕ´Ï´Ù. |
void |
bind (String name,
Object obj,
Attributes attrs)
°ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø ¼Ó¼º°ú ÇÔ²², À̸§À» ¿ÀºêÁ§Æ®¿¡ ¹ÙÀεå ÇÕ´Ï´Ù. |
DirContext |
createSubcontext (Name name,
Attributes attrs)
°ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø ¼Ó¼º°ú ÇÔ²², »õ·Î¿î ÄÁÅØ½ºÆ® À» ÀÛ¼ºÇØ ¹ÙÀεå ÇÕ´Ï´Ù. |
DirContext |
createSubcontext (String name,
Attributes attrs)
°ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø ¼Ó¼º°ú ÇÔ²², À̸§À» ¿ÀºêÁ§Æ®¿¡ ¹ÙÀεå ÇÕ´Ï´Ù. |
Attributes |
getAttributes (Name name)
ÁöÁ¤µÈ ¿ÀºêÁ§Æ®¿¡ °ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø ¼Ó¼ºÀ» ¸ðµÎ ÃëµæÇÕ´Ï´Ù. |
Attributes |
getAttributes (Name name,
String [] attrIds)
ÁöÁ¤µÈ ¿ÀºêÁ§Æ®¿¡ °ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø ¼Ó¼ºÀ¸·Î ¼±ÅÃµÈ °ÍÀ» ÃëµæÇÕ´Ï´Ù. |
Attributes |
getAttributes (String name)
À̸§ ÷ºÎ ¿ÀºêÁ§Æ®¿¡ °ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø ¼Ó¼ºÀ» ¸ðµÎ ÃëµæÇÕ´Ï´Ù. |
Attributes |
getAttributes (String name,
String [] attrIds)
À̸§ ÷ºÎ ¿ÀºêÁ§Æ®¿¡ °ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø ¼Ó¼ºÀ¸·Î ¼±ÅÃµÈ °ÍÀ» ÃëµæÇÕ´Ï´Ù. |
DirContext |
getSchema (Name name)
ÁöÁ¤µÈ ¿ÀºêÁ§Æ®¿¡ °ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø schema¸¦ ÃëµæÇÕ´Ï´Ù. |
DirContext |
getSchema (String name)
À̸§ ÷ºÎ ¿ÀºêÁ§Æ®¿¡ °ü·ÃÇÑ schema¸¦ ÃëµæÇÕ´Ï´Ù. |
DirContext |
getSchemaClassDefinition (Name name)
ÁöÁ¤µÈ ¿ÀºêÁ§Æ®ÀÇ Å¬·¡½º Á¤ÀÇÀÇ schema ¿ÀºêÁ§Æ®¸¦ Æ÷ÇÔÇÑ ÄÁÅØ½ºÆ® À» ÃëµæÇÕ´Ï´Ù. |
DirContext |
getSchemaClassDefinition (String name)
À̸§ ÷ºÎ ¿ÀºêÁ§Æ®ÀÇ Å¬·¡½º Á¤ÀÇÀÇ schema ¿ÀºêÁ§Æ®¸¦ Æ÷ÇÔÇÑ ÄÁÅØ½ºÆ® À» ÃëµæÇÕ´Ï´Ù. |
void |
modifyAttributes (Name name,
int mod_op,
Attributes attrs)
ÁöÁ¤µÈ ¿ÀºêÁ§Æ®¿¡ °ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø ¼Ó¼ºÀ» º¯°æÇÕ´Ï´Ù. |
void |
modifyAttributes (Name name,
ModificationItem [] mods)
º¯°æ¼ø¼ ÁöÁ¤ ¸®½ºÆ®¸¦ »ç¿ëÇØ, ÁöÁ¤µÈ ¿ÀºêÁ§Æ®¿¡ °ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø ¼Ó¼ºÀ» º¯°æÇÕ´Ï´Ù. |
void |
modifyAttributes (String name,
int mod_op,
Attributes attrs)
À̸§ ÷ºÎ ¿ÀºêÁ§Æ®¿¡ °ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø ¼Ó¼ºÀ» º¯°æÇÕ´Ï´Ù. |
void |
modifyAttributes (String name,
ModificationItem [] mods)
¼ø¼ ºÙÀÌ°í µÈ º¯°æ ¸®½ºÆ®¸¦ »ç¿ëÇØ, ÁöÁ¤µÈ ¿ÀºêÁ§Æ®¿¡ °ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø ¼Ó¼ºÀ» º¯°æÇÕ´Ï´Ù. |
void |
rebind (Name name,
Object obj,
Attributes attrs)
°ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø ¼Ó¼º°ú ÇÔ²² À̸§À» ¿ÀºêÁ§Æ®¿¡ ¹ÙÀεå ÇØ, ±âÁ¸ÀÇ ¹ÙÀεùÀ» ¿À¹ö¶óÀ̵å(override) ÇÕ´Ï´Ù. |
void |
rebind (String name,
Object obj,
Attributes attrs)
°ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø ¼Ó¼º°ú ÇÔ²² À̸§À» ¿ÀºêÁ§Æ®¿¡ ¹ÙÀεå ÇØ, ±âÁ¸ÀÇ ¹ÙÀεùÀ» ¿À¹ö¶óÀ̵å(override) ÇÕ´Ï´Ù. |
NamingEnumeration <SearchResult > |
search (Name name,
Attributes matchingAttributes)
ÁöÁ¤µÈ ¼Ó¼º¼¼Æ®¸¦ Æ÷ÇÔÇÑ ¿ÀºêÁ§Æ®¸¦ ´ÜÀÏ ÄÁÅØ½ºÆ® À¸·Î °Ë»öÇÕ´Ï´Ù. |
NamingEnumeration <SearchResult > |
search (Name name,
Attributes matchingAttributes,
String [] attributesToReturn)
ÁöÁ¤µÈ ¼Ó¼º¼¼Æ®¸¦ Æ÷ÇÔÇÑ ¿ÀºêÁ§Æ®¸¦ ´ÜÀÏ ÄÁÅØ½ºÆ® À¸·Î °Ë»öÇØ, ¼±ÅÃÇÑ ¼Ó¼ºÀ» ÃëµæÇÕ´Ï´Ù. |
NamingEnumeration <SearchResult > |
search (Name name,
String filterExpr,
Object [] filterArgs,
SearchControls cons)
À̸§ ÷ºÎ ÄÁÅØ½ºÆ® ¶Ç´Â ÁöÁ¤µÈ ¿ÀºêÁ§Æ®·Î ÁöÁ¤µÈ °Ë»ö ÇÊÅ͸¦ ä¿ì´Â ¿£Æ®¸®¸¦ °Ë»öÇÕ´Ï´Ù. |
NamingEnumeration <SearchResult > |
search (Name name,
String filter,
SearchControls cons)
À̸§ ÷ºÎ ÄÁÅØ½ºÆ® ¶Ç´Â ÁöÁ¤µÈ ¿ÀºêÁ§Æ®·Î ÁöÁ¤µÈ °Ë»ö ÇÊÅ͸¦ ä¿ì´Â ¿£Æ®¸®¸¦ °Ë»öÇÕ´Ï´Ù. |
NamingEnumeration <SearchResult > |
search (String name,
Attributes matchingAttributes)
ÁöÁ¤µÈ ¼Ó¼º¼¼Æ®¸¦ Æ÷ÇÔÇÑ ¿ÀºêÁ§Æ®¸¦ ´ÜÀÏ ÄÁÅØ½ºÆ® À¸·Î °Ë»öÇÕ´Ï´Ù. |
NamingEnumeration <SearchResult > |
search (String name,
Attributes matchingAttributes,
String [] attributesToReturn)
ÁöÁ¤µÈ ¼Ó¼º¼¼Æ®¸¦ Æ÷ÇÔÇÑ ¿ÀºêÁ§Æ®¸¦ ´ÜÀÏ ÄÁÅØ½ºÆ® À¸·Î °Ë»öÇØ, ¼±ÅÃÇÑ ¼Ó¼ºÀ» ÃëµæÇÕ´Ï´Ù. |
NamingEnumeration <SearchResult > |
search (String name,
String filterExpr,
Object [] filterArgs,
SearchControls cons)
À̸§ ÷ºÎ ÄÁÅØ½ºÆ® ¶Ç´Â À̸§ ÷ºÎ ¿ÀºêÁ§Æ®·Î ÁöÁ¤µÈ °Ë»ö ÇÊÅ͸¦ ä¿ì´Â ¿£Æ®¸®¸¦ °Ë»öÇÕ´Ï´Ù. |
NamingEnumeration <SearchResult > |
search (String name,
String filter,
SearchControls cons)
À̸§ ÷ºÎ ÄÁÅØ½ºÆ® ¶Ç´Â À̸§ ÷ºÎ ¿ÀºêÁ§Æ®·Î ÁöÁ¤µÈ °Ë»ö ÇÊÅ͸¦ ä¿ì´Â ¿£Æ®¸®¸¦ °Ë»öÇÕ´Ï´Ù. |
Ŭ·¡½º javax.naming. InitialContext ·ÎºÎÅÍ »ó¼ÓµÈ ¸Þ¼µå |
---|
addToEnvironment,
bind,
bind,
close,
composeName,
composeName,
createSubcontext,
createSubcontext,
destroySubcontext,
destroySubcontext,
getDefaultInitCtx,
getEnvironment,
getNameInNamespace,
getNameParser,
getNameParser,
getURLOrDefaultInitCtx,
getURLOrDefaultInitCtx,
init,
list,
list,
listBindings,
listBindings,
lookup,
lookup,
lookupLink,
lookupLink,
rebind,
rebind,
removeFromEnvironment,
rename,
rename,
unbind,
unbind |
Ŭ·¡½º java.lang. Object ·ÎºÎÅÍ »ó¼ÓµÈ ¸Þ¼µå |
---|
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait |
ÀÎÅÍÆäÀ̽º javax.naming. Context ·ÎºÎÅÍ »ó¼ÓµÈ ¸Þ¼µå |
---|
addToEnvironment,
bind,
bind,
close,
composeName,
composeName,
createSubcontext,
createSubcontext,
destroySubcontext,
destroySubcontext,
getEnvironment,
getNameInNamespace,
getNameParser,
getNameParser,
list,
list,
listBindings,
listBindings,
lookup,
lookup,
lookupLink,
lookupLink,
rebind,
rebind,
removeFromEnvironment,
rename,
rename,
unbind,
unbind |
»ý¼ºÀÚ »ó¼¼ |
---|
protected InitialDirContext(boolean lazy) throws NamingException
lazy
- true´Â
Ãʱâ DirContext °¡ ÃʱâȵÇÁö ¾Ê´Â °ÍÀ» ³ªÅ¸³½´Ù. false´Â
new InitialDirContext()¸¦
È£ÃâÇÏ´Â °Í°ú °°´Ù
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìInitialContext.init(Hashtable)
public InitialDirContext() throws NamingException
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìInitialDirContext(Hashtable)
public InitialDirContext(Hashtable <?,?> environment) throws NamingException
ÀÌ »ý¼ºÀÚ¿¡¼´Â environment º¯°æ ¶Ç´Â ÂüÁ¶ÀÇ º¸Á¸Àº ÇàÇØÁöÁö ¾Ê½À´Ï´Ù¸¸, º¹Á¦°¡ º¸Á¸µË´Ï´Ù.
environment
- Ãʱâ DirContext
ÀÛ¼º¿¡ »ç¿ëµÇ´Â ȯ°æ. null´Â
ÇÏ´ÃÀÇ È¯°æÀ» ³ªÅ¸³½´Ù
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ì¸Þ¼µåÀÇ »ó¼¼ |
---|
public Attributes getAttributes(String name) throws NamingException
DirContext
񃬣: DirContext.getAttributes(Name)
¸¦
ÂüÁ¶ÇϽʽÿÀ.
DirContext
³»ÀÇ getAttributes
name
- ¼Ó¼ºÀÇ Ãëµæ¿øÀÇ ¿ÀºêÁ§Æ®ÀÇ À̸§
name
¿¡ °ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø ¼Ó¼º¼¼Æ®
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìpublic Attributes getAttributes(String name, String [] attrIds) throws NamingException
DirContext
񃬣: DirContext.getAttributes(Name, String[])
¸¦
ÂüÁ¶ÇϽʽÿÀ.
DirContext
³»ÀÇ getAttributes
name
- ¼Ó¼ºÀÇ Ãëµæ¿øÀÇ ¿ÀºêÁ§Æ®ÀÇ À̸§attrIds
- ¾ò´Â
¼Ó¼ºÀÇ ½Äº°ÀÚ. null´Â
¸ðµç ¼Ó¼ºÀÌ ÃëµæµÇ´Â °ÍÀ» ³ªÅ¸³½´Ù. ÇÏ´ÃÀÇ ¹è¿Àº ¾Æ¹«°Íµµ ÃëµæµÇÁö ¾Ê´Â °ÍÀ» ³ªÅ¸³½´Ù
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìpublic Attributes getAttributes(Name name) throws NamingException
DirContext
񃬣:
DirContext
³»ÀÇ getAttributes
name
- ¼Ó¼ºÀÇ Ãëµæ¿øÀÇ ¿ÀºêÁ§Æ®ÀÇ À̸§
name
¿¡ °ü·ÃÁöÀ» ¼ö ÀÖ¾ú´ø ¼Ó¼º¼¼Æ®. À̸§¿¡ ¼Ó¼ºÀÌ ¾ø´Â °æ¿ì, ÇÏ´ÃÀÇ ¼Ó¼º ¼¼Æ®¸¦ µ¹·ÁÁÖ°í, null °¡ µÉ °ÍÀº ¾ø´Ù
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìDirContext.getAttributes(String)
,
DirContext.getAttributes(Name, String[])
public Attributes getAttributes(Name name, String [] attrIds) throws NamingException
DirContext
±â¼ú: ÁöÁ¤µÈ ¼Ó¼ºÀ» ¿ÀºêÁ§Æ®°¡ °¡Áö°í ÀÖÁö ¾ÊÀº °æ¿ì, µð·ºÅ丮´Â Á¸ÀçÇÏÁö ¾Ê´Â ¼Ó¼ºÀ» ¹«½ÃÇØ, ¿ÀºêÁ§Æ®°¡ °¡Áö°í ÀÖ´Â ¿ä±¸µÈ ¼Ó¼ºÀ» µ¹·ÁÁÝ´Ï´Ù.
µð·ºÅ丮´Â ¿ä±¸µÈ ÀÌ»óÀÇ ¼öÀÇ ¼Ó¼ºÀ» µ¹·ÁÁÖ´Â ÀÏÀÌ ÀÖ½À´Ï´Ù (Ŭ·¡½ºÀÇ ¼³¸íÀÇ¡¸¼Ó¼ºÇü¸í¡¹ÂüÁ¶)°¡, ¹«°ü°èÇÑ ÀÓÀÇÀÇ ¼Ó¼ºÀ» µ¹·ÁÁÙ °ÍÀº ¾ø½À´Ï´Ù.
Ŭ·¡½ºÀÇ ¼³¸íÀÇ¡¸Á¶ÀÛ ¼Ó¼º¡¹ µµ ÂüÁ¶ÇϽʽÿÀ.
DirContext
³»ÀÇ getAttributes
name
- ¼Ó¼ºÀÇ Ãëµæ¿øÀÇ ¿ÀºêÁ§Æ®ÀÇ À̸§attrIds
- ¾ò´Â
¼Ó¼ºÀÇ ½Äº°ÀÚ. null´Â
¸ðµç ¼Ó¼ºÀÌ ÃëµæµÇ´Â °ÍÀ» ³ªÅ¸³½´Ù. ÇÏ´ÃÀÇ ¹è¿Àº ¾Æ¹«°Íµµ ÃëµæµÇÁö ¾Ê´Â °ÍÀ» ³ªÅ¸³½´Ù
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìpublic void modifyAttributes(String name, int mod_op, Attributes attrs) throws NamingException
DirContext
񃬣: DirContext.modifyAttributes(Name, int, Attributes)
¸¦
ÂüÁ¶ÇϽʽÿÀ.
DirContext
³»ÀÇ modifyAttributes
name
- ¼Ó¼ºÀÌ º¯°æµÇ´Â ¿ÀºêÁ§Æ®ÀÇ À̸§mod_op
- º¯°æ Á¶ÀÛ,ADD_ATTRIBUTE
,REPLACE_ATTRIBUTE
,REMOVE_ATTRIBUTE
¾î´ÀÂÊÀ̵çattrs
- º¯°æ¿¡ »ç¿ëµÇ´Â ¼Ó¼º. null´Â
ºÒ°¡
AttributeModificationException
- º¯°æÀ» ¿Ï·áÇÒ ¼ö ¾ø´Â °æ¿ì
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìpublic void modifyAttributes(Name name, int mod_op, Attributes attrs) throws NamingException
DirContext
񃬣:
DirContext
³»ÀÇ modifyAttributes
name
- ¼Ó¼ºÀÌ º¯°æµÇ´Â ¿ÀºêÁ§Æ®ÀÇ À̸§mod_op
- º¯°æ Á¶ÀÛ,ADD_ATTRIBUTE
,REPLACE_ATTRIBUTE
,REMOVE_ATTRIBUTE
¾î´ÀÂÊÀ̵çattrs
- º¯°æ¿¡ »ç¿ëµÇ´Â ¼Ó¼º. null´Â
ºÒ°¡
AttributeModificationException
- º¯°æÀ» ¿Ï·áÇÒ ¼ö ¾ø´Â °æ¿ì
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìDirContext.modifyAttributes(Name, ModificationItem[])
public void modifyAttributes(String name, ModificationItem [] mods) throws NamingException
DirContext
񃬣: DirContext.modifyAttributes(Name, ModificationItem[])
¸¦
ÂüÁ¶ÇϽʽÿÀ.
DirContext
³»ÀÇ modifyAttributes
name
- ¼Ó¼ºÀÌ º¯°æµÇ´Â ¿ÀºêÁ§Æ®ÀÇ À̸§mods
- ½ÇÇàµÇ´Â º¯°æÀÇ ¼ø¼. null´Â
ºÒ°¡
AttributeModificationException
- º¯°æÀ» ¿Ï·áÇÒ ¼ö ¾ø´Â °æ¿ì
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìpublic void modifyAttributes(Name name, ModificationItem [] mods) throws NamingException
DirContext
񃬣:
DirContext
³»ÀÇ modifyAttributes
name
- ¼Ó¼ºÀÌ º¯°æµÇ´Â ¿ÀºêÁ§Æ®ÀÇ À̸§mods
- ½ÇÇàµÇ´Â º¯°æÀÇ ¼ø¼. null´Â
ºÒ°¡
AttributeModificationException
- º¯°æÀ» ¿Ï·áÇÒ ¼ö ¾ø´Â °æ¿ì
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìDirContext.modifyAttributes(Name, int, Attributes)
,
ModificationItem
public void bind(String name, Object obj, Attributes attrs) throws NamingException
DirContext
񃬣: DirContext.bind(Name, Object, Attributes)
¸¦
ÂüÁ¶ÇϽʽÿÀ.
DirContext
³»ÀÇ bind
name
- ÇÏ´ÃÀÌ ¾Æ´Ñ ¹ÙÀÎµå µÇ´Â À̸§obj
- null
°¡´É¼ºÀÌ ÀÖ´Â ¹ÙÀÎµå µÇ´Â ¿ÀºêÁ§Æ®attrs
- ¹ÙÀεù¿¡ °ü·ÃÁþ´Â ¿ÀºêÁ§Æ®
NameAlreadyBoundException
- À̸§ÀÌ ¹ú½á ¹ÙÀÎµå µÇ°í ÀÖ´Â °æ¿ì
InvalidAttributesException
- ¹ÙÀεù¿¡ ¡¸Çʼö¡¹ÀÇ ¼Ó¼ºÀÌ Á¦°øµÇ¾î ÀÖÁö ¾ÊÀº °æ¿ì
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìpublic void bind(Name name, Object obj, Attributes attrs) throws NamingException
DirContext
񃬣:
DirContext
³»ÀÇ bind
name
- ÇÏ´ÃÀÌ ¾Æ´Ñ ¹ÙÀÎµå µÇ´Â À̸§obj
- null
°¡´É¼ºÀÌ ÀÖ´Â ¹ÙÀÎµå µÇ´Â ¿ÀºêÁ§Æ®attrs
- ¹ÙÀεù¿¡ °ü·ÃÁþ´Â ¿ÀºêÁ§Æ®
NameAlreadyBoundException
- À̸§ÀÌ ¹ú½á ¹ÙÀÎµå µÇ°í ÀÖ´Â °æ¿ì
InvalidAttributesException
- ¹ÙÀεù¿¡ ¡¸Çʼö¡¹ÀÇ ¼Ó¼ºÀÌ Á¦°øµÇ¾î ÀÖÁö ¾ÊÀº °æ¿ì
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìContext.bind(Name, Object)
,
DirContext.rebind(Name, Object, Attributes)
public void rebind(String name, Object obj, Attributes attrs) throws NamingException
DirContext
񃬣: DirContext.rebind(Name, Object, Attributes)
¸¦
ÂüÁ¶ÇϽʽÿÀ.
DirContext
³»ÀÇ rebind
name
- ÇÏ´ÃÀÌ ¾Æ´Ñ ¹ÙÀÎµå µÇ´Â À̸§obj
- null
°¡´É¼ºÀÌ ÀÖ´Â ¹ÙÀÎµå µÇ´Â ¿ÀºêÁ§Æ®attrs
- ¹ÙÀεù¿¡ °ü·ÃÁþ´Â ¿ÀºêÁ§Æ®
InvalidAttributesException
- ¹ÙÀεù¿¡ ¡¸Çʼö¡¹ÀÇ ¼Ó¼ºÀÌ Á¦°øµÇ¾î ÀÖÁö ¾ÊÀº °æ¿ì
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìpublic void rebind(Name name, Object obj, Attributes attrs) throws NamingException
DirContext
񃬣:
DirContext
³»ÀÇ rebind
name
- ÇÏ´ÃÀÌ ¾Æ´Ñ ¹ÙÀÎµå µÇ´Â À̸§obj
- null
°¡´É¼ºÀÌ ÀÖ´Â ¹ÙÀÎµå µÇ´Â ¿ÀºêÁ§Æ®attrs
- ¹ÙÀεù¿¡ °ü·ÃÁþ´Â ¿ÀºêÁ§Æ®
InvalidAttributesException
- ¹ÙÀεù¿¡ ¡¸Çʼö¡¹ÀÇ ¼Ó¼ºÀÌ Á¦°øµÇ¾î ÀÖÁö ¾ÊÀº °æ¿ì
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìContext.bind(Name, Object)
,
DirContext.bind(Name, Object, Attributes)
public DirContext createSubcontext(String name, Attributes attrs) throws NamingException
DirContext
񃬣: DirContext.createSubcontext(Name, Attributes)
¸¦
ÂüÁ¶ÇϽʽÿÀ.
DirContext
³»ÀÇ createSubcontext
name
- ÇÏ´ÃÀÌ ¾Æ´Ñ ÀÛ¼ºµÇ´Â ÄÁÅØ½ºÆ®
ÀÇ À̸§attrs
- »õ·Ó°Ô ÀÛ¼ºµÈ ÄÁÅØ½ºÆ®
¿¡ °ü·ÃÁþ´Â ¿ÀºêÁ§Æ®
NameAlreadyBoundException
- À̸§ÀÌ ¹ú½á ¹ÙÀÎµå µÇ°í ÀÖ´Â °æ¿ì
InvalidAttributesException
- ÀÛ¼º¿¡ ÇÊ¿äÇÑ Çʼö ¼Ó¼º attrs
°¡ ÀϺΠ¹Û¿¡ Æ÷ÇÔµÇÁö ¾ÊÀº °æ¿ì
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìpublic DirContext createSubcontext(Name name, Attributes attrs) throws NamingException
DirContext
񃬣:
DirContext
³»ÀÇ createSubcontext
name
- ÇÏ´ÃÀÌ ¾Æ´Ñ ÀÛ¼ºµÇ´Â ÄÁÅØ½ºÆ®
ÀÇ À̸§attrs
- »õ·Ó°Ô ÀÛ¼ºµÈ ÄÁÅØ½ºÆ®
¿¡ °ü·ÃÁþ´Â ¿ÀºêÁ§Æ®
NameAlreadyBoundException
- À̸§ÀÌ ¹ú½á ¹ÙÀÎµå µÇ°í ÀÖ´Â °æ¿ì
InvalidAttributesException
- ÀÛ¼º¿¡ ÇÊ¿äÇÑ Çʼö ¼Ó¼º attrs
°¡ ÀϺΠ¹Û¿¡ Æ÷ÇÔµÇÁö ¾ÊÀº °æ¿ì
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìContext.createSubcontext(Name)
public DirContext getSchema(String name) throws NamingException
DirContext
񃬣: DirContext.getSchema(Name)
¸¦
ÂüÁ¶ÇϽʽÿÀ.
DirContext
³»ÀÇ getSchema
name
- schemaÀÇ Ãëµæ¿ø¿ÀºêÁ§Æ®ÀÇ À̸§
OperationNotSupportedException
- schema°¡ ¼Æ÷Æ®µÇ¾î ÀÖÁö ¾ÊÀº °æ¿ì
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìpublic DirContext getSchema(Name name) throws NamingException
DirContext
±â¼ú: ÀÌ ¸Þ¼µå´Â ÁöÁ¤µÈ ¿ÀºêÁ§Æ®¿¡ Àû¿ëÇÒ ¼ö ÀÖ´Â schema Á¤º¸ Æ®¸®ÀÇ ·çÆ®¸¦ µ¹·ÁÁÝ´Ï´Ù. ÁöÁ¤µÈ ¿ÀºêÁ§Æ® (¶Ç´Â µð·ºÅ丮 Àüü)ÀÇ ¸î°³Àΰ¡°¡, °°Àº schema¸¦ °øÀ¯ÇÏ´Â °æ¿ì°¡ ÀÖ½À´Ï´Ù.
schema Æ®¸®ÀÇ ±¸Á¶¿Í ³»¿ë, schema Æ®¸®ÀÇ ³»¿ëÀÇ º¯°æ Çã°¡, ÀÌ·¯ÇÑ º¯°æÀÇ µð·ºÅ丮¿¡ÀÇ ¿µÇâµîÀÇ ¹®Á¦´Â ±âº»ÀÌ µÇ´Â µð·ºÅ丮¿¡ ÇØ ´Ù¸¨´Ï´Ù.
DirContext
³»ÀÇ getSchema
name
- schemaÀÇ Ãëµæ¿ø¿ÀºêÁ§Æ®ÀÇ À̸§
OperationNotSupportedException
- schema°¡ ¼Æ÷Æ®µÇ¾î ÀÖÁö ¾ÊÀº °æ¿ì
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìpublic DirContext getSchemaClassDefinition(String name) throws NamingException
DirContext
񃬣: DirContext.getSchemaClassDefinition(Name)
¸¦
ÂüÁ¶ÇϽʽÿÀ.
DirContext
³»ÀÇ getSchemaClassDefinition
name
- ¿ÀºêÁ§Æ® Ŭ·¡½º Á¤ÀÇÀÇ Ãëµæ¿ø¿ÀºêÁ§Æ®ÀÇ À̸§
OperationNotSupportedException
- schema°¡ ¼Æ÷Æ®µÇ¾î ÀÖÁö ¾ÊÀº °æ¿ì
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìpublic DirContext getSchemaClassDefinition(Name name) throws NamingException
DirContext
±â¼ú: µð·ºÅ丮 schemaÀÇ Á¤º¸ Ä«Å×°í¸®ÀÇ 1 °³¿¡ ¡¸Å¬·¡½º Á¤ÀÇ¡¹°¡ ÀÖ½À´Ï´Ù. ¡¸¿ÀºêÁ§Æ® Ŭ·¡½º¡¹ÀÇ Á¤ÀÇ´Â ¿ÀºêÁ§Æ®ÀÇ ¡¸ÇüÅ¡¹ ¹× ±× ¿ÀºêÁ§Æ®°¡ °¡Áú Çʿ䰡 ÀÖ´Â ¼Ó¼º°ú °¡Áú ¼ö ÀÖ´Â ¼Ó¼º (Çʼö¿Í ÀÓÀÇ)À» ÁöÁ¤ÇÕ´Ï´Ù. ¿©±â¼ ¸»ÇÏ´Â ¡¸¿ÀºêÁ§Æ® Ŭ·¡½º¡¹´Â Java ÀûÀÎ ¹Ì´Â ¾Æ´Ï°í, µð·ºÅ丮ÀûÀÎ ¹Ì·Î »ç¿ëµÇ°í ÀÖ½À´Ï´Ù. ¿¹¸¦ µé¾î, ÁöÁ¤µÈ ¿ÀºêÁ§Æ®°¡ ¡¸Person¡¹Å¬·¡½ºÀÇ µð·ºÅ丮 ¿ÀºêÁ§Æ®ÀÎ °æ¿ì,getSchemaClassDefinition()´Â ¡¸Person¡¹ÀÇ (µð·ºÅ丮ÀÇ) ¿ÀºêÁ§Æ® Ŭ·¡½º Á¤ÀǸ¦ ³ªÅ¸³»´Â DirContext¸¦ µ¹·ÁÁÝ´Ï´Ù.
¿ÀºêÁ§Æ® Ŭ·¡½º Á¤ÀǷκÎÅÍ ÃëµæÇÒ ¼ö ÀÖ´Â Á¤º¸´Â µð·ºÅ丮 Á¸ÀÔ´Ï´Ù.
JNDI 1.2 º¸´Ù ÀüÀº, ÀÌ ¸Þ¼µå´Â ÁöÁ¤µÈ ¿ÀºêÁ§Æ®ÀÇ Å¬·¡½º Á¤ÀǸ¦ ³ªÅ¸³»´Â ´ÜÀÏÀÇ schema ¿ÀºêÁ§Æ®¸¦ µ¹·ÁÁÖ°í ÀÖ¾ú½À´Ï´Ù. JNDI 1.2 ·ÎºÎÅÍ´Â ÀÌ ¸Þ¼µå´Â ÁöÁ¤µÈ ¿ÀºêÁ§Æ®ÀÇ Å¬·¡½º Á¤ÀǸ¦ ¸ðµÎ Æ÷ÇÔÇÑ DirContext¸¦ µ¹·ÁÁÝ´Ï´Ù.
DirContext
³»ÀÇ getSchemaClassDefinition
name
- ¿ÀºêÁ§Æ® Ŭ·¡½º Á¤ÀÇÀÇ Ãëµæ¿ø¿ÀºêÁ§Æ®ÀÇ À̸§
OperationNotSupportedException
- schema°¡ ¼Æ÷Æ®µÇ¾î ÀÖÁö ¾ÊÀº °æ¿ì
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìpublic NamingEnumeration <SearchResult > search(String name, Attributes matchingAttributes) throws NamingException
DirContext
񃬣: DirContext.search(Name, Attributes)
¸¦
ÂüÁ¶ÇϽʽÿÀ.
DirContext
³»ÀÇ search
name
- °Ë»öÇÏ´Â ÄÁÅØ½ºÆ®
ÀÇ À̸§matchingAttributes
- °Ë»öÇÏ´Â ¼Ó¼º
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìpublic NamingEnumeration <SearchResult > search(Name name, Attributes matchingAttributes) throws NamingException
DirContext
񃬣: search(Name, Attributes, String[])
¿¡ null¸¦
Á¦°øÇÏ´Â °Í°ú µ¿µîÇÕ´Ï´Ù. DirContext.search(Name, Attributes, String[])
¸¦
ÂüÁ¶ÇϽʽÿÀ.
DirContext
³»ÀÇ search
name
- °Ë»öÇÏ´Â ÄÁÅØ½ºÆ®
ÀÇ À̸§matchingAttributes
- °Ë»öÇÏ´Â ¼Ó¼º
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìDirContext.search(Name, Attributes, String[])
public NamingEnumeration <SearchResult > search(String name, Attributes matchingAttributes, String [] attributesToReturn) throws NamingException
DirContext
񃬣: DirContext.search(Name, Attributes, String[])
¸¦
ÂüÁ¶ÇϽʽÿÀ.
DirContext
³»ÀÇ search
name
- °Ë»öÇÏ´Â ÄÁÅØ½ºÆ®
ÀÇ À̸§matchingAttributes
- °Ë»öÇÏ´Â ¼Ó¼ºattributesToReturn
- µ¹·ÁÁÖ´Â ¼Ó¼º
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìpublic NamingEnumeration <SearchResult > search(Name name, Attributes matchingAttributes, String [] attributesToReturn) throws NamingException
DirContext
񃬣: SearchControls
¼³Á¤À» »ç¿ëÇØ ÇàÇØÁý´Ï´Ù.
¿ÀºêÁ§Æ®¸¦ ¼±ÅÃÇϱâ À§Çؼ´Â
matchingAttributes
°¢ ¼Ó¼ºÀÌ ¿ÀºêÁ§Æ®ÀÇ ¼Ó¼ºÀÇ ¾î´ÀÂÊÀ̵çÀÏÄ¡ÇÒ Çʿ䰡 ÀÖ½À´Ï´Ù. matchingAttributes
°¡ ÇÏ´Ã ¶Ç´Â null
°æ¿ì, Ÿ°Ù ÄÁÅØ½ºÆ®
ÀÇ ¸ðµç ¿ÀºêÁ§Æ®°¡ µ¹·ÁÁÖ°íÁý´Ï´Ù.
matchingAttributes
¼Ó¼º A1 À¸·Î ¿ÀºêÁ§Æ®ÀÇ ¼Ó¼º A2 °¡ °°Àº ½Äº°ÀÚ¸¦ °¡Áö°í ÀÖ¾îA1
°¢ Ä¡°¡ A2
°ªÀÇ ¾î´À ÂÊÀΰ¡¿¡ µ¿ÀÏÇÑ °æ¿ì,A1 Àº A2 ¿¡ ÀÏÄ¡ÇÑ´Ù°í º¸ÀÔ´Ï´Ù. À̰ÍÀº, °ªÀÇ ¼ø¼´Â Áß¿äÇÏÁö ¾Ê°í, ¶Ç A2 °¡ A1 ¿¡ ¾ø´Â ¡¸¿©ºÐÀÇ¡¹°ªÀ» Æ÷ÇÔÇϰí À־ ºñ±³¿¡´Â ¿µÇâÀÌ ¾ø´Â °ÍÀ»
¹ÌÇÕ´Ï´Ù. °Ô´Ù°¡A1 ÀÌ °ªÀ» °¡Áö°í ÀÖÁö ¾ÊÀº °æ¿ì, ÀÏÄ¡ÀÇ Å×½ºÆ®´Â
°°Àº ½Äº°ÀÚ¸¦ °¡Áö´Â ¼Ó¼º A2 °¡ Á¸ÀçÇÒÁö ¾î¶³Áö¸¦ Á¶»çÇÏ´Â °Í°ú °°Àº ¶æÀÌ µË´Ï´Ù.
¼Ó¼ºÄ¡¸¦ ºñ±³Çϴµ¥ »ç¿ëµÇ´Â ¡¸µ¿µî¡¹ÀÇ »ó¼¼ÇÑ Á¤ÀÇ´Â
±âº»ÀÌ µÇ´Â µð·ºÅ丮 ¼ºñ½º¿¡
ÇØ Á¤Àǵ˴ϴÙ. Á¤ÀÇ¿¡´Â
¿¹¸¦ µé¾î Object.equals
¸Þ¼µå¸¦ »ç¿ëÇÏ´Â °æ¿ìµµ ÀÖÀ¸¸é, schema¸¦ »ç¿ëÇØ ´Ù¸¥ µ¿µî Á¶ÀÛÀ» ÁöÁ¤ÇÏ´Â °æ¿ìµµ ÀÖ½À´Ï´Ù. µ¿µî ÀÌ¿ÜÀÇ Á¶ÀÛ¿¡ ±Ù°ÅÇÏ´Â ¸ÅĪ (ºÎºÐ ij¸¯ÅÍ ¶óÀÎÀÇ ºñ±³µî)¿¡´Â
ÇÊÅÍ Àμö¸¦ ÃëÇÏ´Â search
¸Þ¼µåÀÇ ¹öÁ¯À» »ç¿ëÇÕ´Ï´Ù.
ÀÌ DirContext ·Î º¯°æÀ» ÇßÀ» °æ¿ì, º¯°æÀüÀÇ ÀÌ ¸Þ¼µå¿¡ ´ëÇÑ È£Ãâ¿¡ ÇØ µ¹·ÁÁÖ°íÁø ¿°ÅÀÇ °á°ú´Â Á¤Àǵǰí ÀÖÁö ¾Ê½À´Ï´Ù.
ÁöÁ¤µÈ ¼Ó¼ºÀ» ¿ÀºêÁ§Æ®°¡ °¡Áö°í ÀÖÁö ¾ÊÀº °æ¿ì, µð·ºÅ丮´Â Á¸ÀçÇÏÁö ¾Ê´Â ¼Ó¼ºÀ» ¹«½ÃÇØ, ¿ÀºêÁ§Æ®°¡ °¡Áö°í ÀÖ´Â ¿ä±¸µÈ ¼Ó¼ºÀ» µ¹·ÁÁÝ´Ï´Ù.
µð·ºÅ丮´Â ¿ä±¸µÈ ÀÌ»óÀÇ ¼öÀÇ ¼Ó¼ºÀ» µ¹·ÁÁÖ´Â ÀÏÀÌ ÀÖ½À´Ï´Ù (Ŭ·¡½ºÀÇ ¼³¸íÀÇ¡¸¼Ó¼ºÇü¸í¡¹ÂüÁ¶)°¡, ¹«°ü°èÇÑ ÀÓÀÇÀÇ ¼Ó¼ºÀ» µ¹·ÁÁÙ °ÍÀº ¾ø½À´Ï´Ù.
Ŭ·¡½ºÀÇ ¼³¸íÀÇ¡¸Á¶ÀÛ ¼Ó¼º¡¹ µµ ÂüÁ¶ÇϽʽÿÀ.
DirContext
³»ÀÇ search
name
- °Ë»öÇÏ´Â ÄÁÅØ½ºÆ®
ÀÇ À̸§matchingAttributes
- °Ë»öÇÏ´Â ¼Ó¼º. ÇÏ´Ã ¶Ç´Â null
°æ¿ì, Ÿ°Ù ÄÁÅØ½ºÆ®
ÀÇ ¸ðµç ¿ÀºêÁ§Æ®°¡ µ¹·ÁÁÖ°íÁö´ÂattributesToReturn
- µ¹·ÁÁÖ´Â ¼Ó¼º. null´Â
¸ðµç ¼Ó¼ºÀÌ µ¹·ÁÁÖ°íÁö´Â °ÍÀ» ³ªÅ¸³½´Ù. ÇÏ´ÃÀÇ ¹è¿Àº ¾Æ¹«°Íµµ µ¹·ÁÁÖ°íÁöÁö ¾ÊÀº °ÍÀ» ³ªÅ¸³½´Ù
attributesToReturn
¿¡
ÇØ ½Äº°µÈ ¼Ó¼º ¹× name
¿¡
ÇØ À̸§ÀÌ ºÙ¿©Áø ÄÁÅØ½ºÆ®
¿¡ °ü·ÃÇØ À̸§ÀÌ ºÙ¿©Áø ÇØ´ç ¿ÀºêÁ§Æ®ÀÇ À̸§À» Æ÷ÇÔÇÑ´Ù
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìSearchControls
,
SearchResult
,
DirContext.search(Name, String, Object[], SearchControls)
public NamingEnumeration <SearchResult > search(String name, String filter, SearchControls cons) throws NamingException
DirContext
񃬣: DirContext.search(Name, String, SearchControls)
¸¦
ÂüÁ¶ÇϽʽÿÀ.
DirContext
³»ÀÇ search
name
- °Ë»öÇÏ´Â ÄÁÅØ½ºÆ®
¶Ç´Â ¿ÀºêÁ§Æ®ÀÇ À̸§filter
- °Ë»ö¿¡ »ç¿ëÇÏ´Â ÇÊÅͽÄ. null´Â
ºÒ°¡cons
- °Ë»öÀ» Á¦¾îÇÏ´Â °Ë»ö Á¦¾î. null
°æ¿ì, µðÆúÆ®ÀÇ °Ë»ö Á¦¾î°¡ »ç¿ëµÈ´Ù ((new SearchControls()) ¿Í µ¿µî)
InvalidSearchFilterException
- ±âº»ÀÌ µÇ´Â µð·ºÅ丮°¡, ÁöÁ¤µÈ °Ë»ö ÇÊÅ͸¦ ¼Æ÷Æ®Çϰí ÀÖÁö ¾Ê´ÂÁö, ÀνÄÇÏÁö ¾Ê´Â °æ¿ì
InvalidSearchControlsException
- °Ë»ö Á¦¾î°¡ ¹«È¿ÀÎ ¼³Á¤À» Æ÷ÇÔÇϰí ÀÖ´Â °æ¿ì
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìpublic NamingEnumeration <SearchResult > search(Name name, String filter, SearchControls cons) throws NamingException
DirContext
񃬣:
filter
Çü½Ä°ú ÇØ¼®Àº, RFC 2254 ¿¡ ÁذÅÇϰí ÀÖ½À´Ï´Ù. attr
¹× value
¿¡ ´ëÇÑ ÇØ¼®Àº RFC ¿¡ ´ÙÀ½°ú °°ÀÌ Á¤Àǵǰí ÀÖ½À´Ï´Ù.
attr
´Â
¼Ó¼ºÀÇ ½Äº°ÀÚÀÔ´Ï´Ù.
value
´Â
¼Ó¼ºÀÇ °ªÀÇ Ä³¸¯ÅÍ ¶óÀΠǥÇöÀÔ´Ï´Ù. ¼Ó¼ºÄ¡¿¡ÀÇ ÀÌ Ä³¸¯ÅÍ ¶óÀΠǥÇöÀÇ ÆòÇàÀ̵¿Àº, µð·ºÅ丮¿¡ °íÀ¯ÇÕ´Ï´Ù.
¿¹¸¦ µé¾î ¡¸someCount=127¡¹(ÀÌ)¶ó°í ÇÏ´Â ´ëÀÔ½ÄÀÇ °æ¿ì,attr
´Â
¡¸someCount¡¹·Îvalue
´Â
¡¸127¡¹ÀÔ´Ï´Ù. ¼Ó¼º ID ( ¡¸someCount¡¹) ¹× °æ¿ì¿¡ µû¶ó¼´Â ±× schema¿¡ ±Ù°ÅÇØ, ÇÁ·Î¹ÙÀÌ´õ´Â ¼Ó¼ºÀÇ °ªÀÌ Á¤¼öÇüÀÎ °ÍÀ» ÆÇº°ÇÕ´Ï´Ù. ÇÁ·Î¹ÙÀÌ´õ´Â °è¼ÓµÇ¾î ij¸¯ÅÍ ¶óÀÎ ¡¸127¡¹À» ÀûÀýÈ÷ ±¸¹® ºÐ¼® ÇÕ´Ï´Ù.
ÇÊÅÍ Ä³¸¯ÅÍ ¶óÀÎÀÇ ASCII ÀÌ¿ÜÀÇ ¹®ÀÚ´Â ÇØ´çÇÏ´Â Java (Unicode) ¹®ÀÚ·Î ³ªÅ¸³», UTF-8 8Áßâ¿¡ÀÇ encode´Â ÇÏÁö ¾Ê½À´Ï´Ù. ȤÀº, RFC 2254 ·Î Áø¼úµÇ°í ÀÖ´Â ¡¸backslash - 16 Áø¼öÀÚ¡¹Ç¥±â¹ýµµ »ç¿ëÇÒ ¼ö ÀÖ½À´Ï´Ù.
µð·ºÅ丮°¡ ±× ¼Ó¼ºÀÇ ¸î°³Àΰ¡ ¶Ç´Â ÀüºÎÀÇ Ä³¸¯ÅÍ ¶óÀΠǥÇöÀ» ¼Æ÷Æ®Çϰí ÀÖÁö ¾Ê´Â °æ¿ì, ´ë½Å¿¡ ÇÊÅÍ Àμö¸¦ Objects
ÇüÅ·Π¹Þ¾ÆµéÀÌ´Â search
Çü½ÄÀ» »ç¿ëÇÒ ¼ö ÀÖ½À´Ï´Ù. ÀÌ·¯ÇÑ µð·ºÅ丮ÀÇ ¼ºñ½º ÇÁ·Î¹ÙÀÌ´õ´Â
ÇÊÅÍ Àμö¸¦ ÇÊÅÍ Æò°¡ÀÇ ±× ¼ºñ½º ƯÁ¤ÀÇ Ç¥Çö¿¡ ÆòÇàÀ̵¿ ÇÕ´Ï´Ù. search(Name, String, Object[], SearchControls)
¸¦
ÂüÁ¶ÇϽʽÿÀ.
RFC 2254´Â ºÎºÐ ij¸¯ÅÍ ¶óÀÎ ÀÏÄ¡, µî°¡, ±Ù»ç ÀÏÄ¡, º¸´Ù ´ë, º¸´Ù ¼Ò¸¦ Æ÷ÇÔÇÑ ¼ÒÁ¤ÀÇ ¿¬»êÀÚ¸¦ Á¤ÀÇÇÕ´Ï´Ù. ÀÌ·¯ÇÑ ¿¬»êÀÚ´Â ´ëÀÀÇÏ´Â ½Ã¸àƽ½º¿Í ÇÔ²² ±âº»ÀÌ µÇ´Â µð·ºÅ丮¿¡ ÀÖ´Â ¿¬»êÀÚ¿¡ ¸Ê µË´Ï´Ù. ¿¹¸¦ µé¾î, µ¿µî ¿¬»êÀÚÀÇ °æ¿ì, µð·ºÅ丮´Â ÇÊÅÍÀÇ ¼Ó¼ºÀÇ ¡¸µ¿µî¡¹À» Á¤ÀÇÇÏ´Â ÀÏÄ¡ ±ÔÄ¢À» °¡Áö°í ÀÖ´Ù°í ÇÕ´Ï´Ù. ÀÌ ±ÔÄ¢À» »ç¿ëÇØ, ÇÊÅÍ·Î ÁöÁ¤µÈ ¼Ó¼º°ú µð·ºÅ丮ÀÇ ¿ÀºêÁ§Æ®ÀÇ ¼Ó¼ºÀÌ µ¿µîÇѰ¡ ¾î¶²°¡¸¦ Á¶»çÇÕ´Ï´Ù. °°ÀÌ µð·ºÅ丮°¡ ¼ø¼ºÎÀÇ ±ÔÄ¢À» °¡Áö°í ÀÖÀ¸¸é, ÀÌ ±ÔÄ¢À» »ç¿ëÇØ ¡¸º¸´Ù ´ë¡¹ ¹× ¡¸º¸´Ù ¼Ò¡¹ÀÇ ºñ±³¸¦ ÇÕ´Ï´Ù.
RFC 2254 ·Î Á¤Àǵǰí ÀÖ´Â ¿¬»êÀÚÀÇ ¸ðµç °ÍÀ» ¸ðµç ¼Ó¼º¿¡ Àû¿ëÇÒ ¼ö ÀÖ´Â °ÍÀº ¾Æ´Õ´Ï´Ù. ¿¬»êÀÚ¸¦ Àû¿ëÇÒ ¼ö ¾ø´Â °æ¿ì, ¿¹¿Ü InvalidSearchFilterException
°¡ Throw µË´Ï´Ù.
SearchResult
¿°ÅÀÇ ÇüÅ·Π°á°ú°¡ µ¹·ÁÁÖ°íÁý´Ï´Ù. °¢ SearchResult´Â
¿ÀºêÁ§Æ®ÀÇ À̸§À̳ª ±× ¿Ü ¿ÀºêÁ§Æ®¿¡ °üÇÑ Á¤º¸¸¦ Æ÷ÇÔÇϰí ÀÖ½À´Ï´Ù (SearchResult ÂüÁ¶). À̸§Àº, °Ë»öÀÇ Å¸°Ù ÄÁÅØ½ºÆ®
¿¡ °ü·ÃÇϰí ÀÖ´Â (name
ÆÄ¶ó¹ÌÅÍ¿¡
ÇØ À̸§ÀÌ ºÙ¿©Áø´Ù)Àΰ¡, URL ij¸¯ÅÍ ¶óÀÎÀϱîÀÇ ¾î´À ÂÊÀÎÁöÀÔ´Ï´Ù. cons
°¡ SearchControls.OBJECT_SCOPE
¶Ç´Â SearchControls.SUBSTREE_SCOPE
°Ë»ö ¹üÀ§¸¦ ÁöÁ¤ÇÏ´Â °æ¿ì¿¡ »ý°¢µÇµµ·Ï, Ÿ°Ù ÄÁÅØ½ºÆ®
ÀÌ ¿°Å¿¡ Æ÷ÇԵǴ °æ¿ì, ±× À̸§Àº ÇÏ´ÃÀÇ Ä³¸¯ÅÍ ¶óÀÎÀÔ´Ï´Ù. ÀÏÄ¡ ¿ÀºêÁ§Æ®ÀÇ ¼Ó¼ºÀ» µ¹·ÁÁÖµµ·Ï(µíÀÌ) cons Àμö°¡ ÁöÁ¤ÇßÀ» °æ¿ì,SearchResult´Â
±× ¼Ó¼ºµµ Æ÷ÇÔÇÏ´Â ÀÏÀÌ ÀÖ½À´Ï´Ù.
¿ä±¸µÈ ¼Ó¼ºÀ» ¿ÀºêÁ§Æ®°¡ °¡Áö°í ÀÖÁö ¾ÊÀº °æ¿ì, ±× Á¸ÀçÇÏÁö ¾Ê´Â ¼Ó¼ºÀº ¹«½ÃµË´Ï´Ù. ¿ÀºêÁ§Æ®°¡ °¡Áö°í ÀÖ´Â ¿ä±¸µÈ ¼Ó¼ºÀÌ µ¹·ÁÁÖ°íÁý´Ï´Ù.
µð·ºÅ丮´Â ¿ä±¸µÈ ÀÌ»óÀÇ ¼öÀÇ ¼Ó¼ºÀ» µ¹·ÁÁÖ´Â ÀÏÀÌ ÀÖ½À´Ï´Ù (Ŭ·¡½ºÀÇ ¼³¸íÀÇ¡¸¼Ó¼ºÇü¸í¡¹ ÂüÁ¶)°¡, ¹«°ü°èÇÑ ÀÓÀÇÀÇ ¼Ó¼ºÀ» µ¹·ÁÁÙ °ÍÀº ¾ø½À´Ï´Ù.
Ŭ·¡½ºÀÇ ¼³¸íÀÇ¡¸Á¶ÀÛ ¼Ó¼º¡¹ µµ ÂüÁ¶ÇϽʽÿÀ.
DirContext
³»ÀÇ search
name
- °Ë»öÇÏ´Â ÄÁÅØ½ºÆ®
¶Ç´Â ¿ÀºêÁ§Æ®ÀÇ À̸§filter
- °Ë»ö¿¡ »ç¿ëÇÏ´Â ÇÊÅͽÄ. null´Â
ºÒ°¡cons
- °Ë»öÀ» Á¦¾îÇÏ´Â °Ë»ö Á¦¾î. null
°æ¿ì, µðÆúÆ®ÀÇ °Ë»ö Á¦¾î°¡ »ç¿ëµÈ´Ù ((new SearchControls()) ¿Í µ¿µî)
InvalidSearchFilterException
- ±âº»ÀÌ µÇ´Â µð·ºÅ丮°¡, ÁöÁ¤µÈ °Ë»ö ÇÊÅ͸¦ ¼Æ÷Æ®Çϰí ÀÖÁö ¾Ê´ÂÁö, ÀνÄÇÏÁö ¾Ê´Â °æ¿ì
InvalidSearchControlsException
- °Ë»ö Á¦¾î°¡ ¹«È¿ÀÎ ¼³Á¤À» Æ÷ÇÔÇϰí ÀÖ´Â °æ¿ì
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìDirContext.search(Name, String, Object[], SearchControls)
,
SearchControls
,
SearchResult
public NamingEnumeration <SearchResult > search(String name, String filterExpr, Object [] filterArgs, SearchControls cons) throws NamingException
DirContext
񃬣: DirContext.search(Name, String, Object[], SearchControls)
¸¦
ÂüÁ¶ÇϽʽÿÀ.
DirContext
³»ÀÇ search
name
- °Ë»öÇÏ´Â ÄÁÅØ½ºÆ®
¶Ç´Â ¿ÀºêÁ§Æ®ÀÇ À̸§filterExpr
- °Ë»ö¿¡ »ç¿ëÇÏ´Â ÇÊÅͽÄ. ½Ä¿¡´Â Æû ¡¸{i}
¡¹ÀÇ º¯¼ö¸¦ Æ÷ÇÔÇÒ ¼ö°¡ ÀÖ´Ù. i
´Â
ºÎ°¡ ¾Æ´Ñ Á¤¼ö. null´Â
ºÒ°¡filterArgs
- filterExpr
º¯¼ö¸¦ ġȯÇÏ´Â ÀμöÀÇ ¹è¿. filterArgs[i]
°ªÀÌ °¢ ¡¸{i}
¡¹¸¦ ġȯÇÑ´Ù. null
°æ¿ì, ÇÏ´ÃÀÇ ¹è¿°ú µ¿µîcons
- °Ë»öÀ» Á¦¾îÇÏ´Â °Ë»ö Á¦¾î. null
°æ¿ì, µðÆúÆ®ÀÇ °Ë»ö Á¦¾î°¡ »ç¿ëµÈ´Ù ((new SearchControls()) ¿Í µ¿µî)
InvalidSearchControlsException
- cons °¡ ¹«È¿ÀÎ ¼³Á¤À» Æ÷ÇÔÇϰí ÀÖ´Â °æ¿ì
InvalidSearchFilterException
- filterArgs¸¦
°¡Áö´Â filterExpr °¡ ¹«È¿ÀÎ °Ë»ö ÇÊÅ͸¦ ³ªÅ¸³»°í ÀÖ´Â °æ¿ì
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìpublic NamingEnumeration <SearchResult > search(Name name, String filterExpr, Object [] filterArgs, SearchControls cons) throws NamingException
DirContext
񃬣: filterExpr
ÇØ¼®Àº, RFC 2254 ¿¡ ±Ù°ÅÇϰí ÀÖ½À´Ï´Ù. ÀÌ ¹Û¿¡
filterArgs
¹è¿ÀÇ ¿ÀºêÁ§Æ®¿¡ °ü·ÃµÈ Æû {i}
º¯¼ö¸¦ Æ÷ÇÔÇÑ °æ¿ì°¡ ÀÖ½À´Ï´Ù. i
´Â
Á¤¼öÀÔ´Ï´Ù. ±× ¿ÜÀÇ Á¡¿¡¼´Â
filterExpr
ÇØ¼®Àº, ¸Þ¼µå search(Name, String, SearchControls)
filter
ÆÄ¶ó¹ÌÅÍÀÇ ÇØ¼®°ú µ¿ÀÏÇÕ´Ï´Ù.
º¯¼ö {i}
°¡ °Ë»ö ÇÊÅÍ¿¡ ÀÖ´Â °æ¿ì, ÇÊÅÍ Àμö filterArgs[i]
°¡ ±× ÀÚ¸®¼Ò¿¡ »ç¿ëµÇ´Â °ÍÀ» ³ªÅ¸³»°í ÀÖ½À´Ï´Ù. ÀÌ·¯ÇÑ º¯¼ö´Â
attr,value, ¶Ç´Â matchingrule »ý¼ºÀÌ RFC 2254, ¼½¼Ç 4
ÇÊÅÍ ¹®¹ýÀ¸·Î °ÔÀçµÇ´Â Àå¼Ò¶ó¸é ¾îµð¿¡¼¶óµµ »ç¿ëÇÒ ¼ö ÀÖ½À´Ï´Ù. ij¸¯ÅÍ ¶óÀÎÄ¡ ÇÊÅÍÀÇ Àμö°¡ º¯¼ö¸¦ ġȯÇÏ´Â °æ¿ì, ÇÊÅʹ ij¸¯ÅÍ ¶óÀÎÀÌ º¯¼ö ´ë½Å¿¡ ÁöÁ¤µÈ °Íó·³ ÇØ¼®µÇ¾î RFC 2254
±ÔÄ¢¿¡ µû¶ó, ÇÊÅͳ»ÀÇ Æ¯¼öÇÑ
¹Ì¸¦ °¡Áö´Â ¹®ÀÚ ('*'
µî)´Â À̽ºÄÉÀÌÇÁ µË´Ï´Ù.
¼Ó¼ºÀÇ ÀϺΠ¶Ç´Â ÀüºÎ¿¡ ij¸¯ÅÍ ¶óÀΠǥÇöÀ» »ç¿ëÇÏÁö ¾Ê´Â µð·ºÅ丮ÀÇ °æ¿ì, ¼Ó¼ºÄ¡¿¡ ´ëÀÀÇÏ´Â ÇÊÅÍ Àμö´Â String ÀÌ¿ÜÀÇ ÇüÅÂÀÇ °¡´É¼ºÀÌ ÀÖ½À´Ï´Ù. ¿¹¸¦ µé¾î, ±¸Á¶ÈµÇ¾î ÀÖÁö ¾ÊÀº 2 Áø¼öÀÇ ¼Ó¼ºÀ» Áö¿øÇÏ´Â µð·ºÅ丮´Â ¹ÙÀÌÆ® ¹è¿À» ÇÊÅÍ Àμö·Î¼ ¹Þ¾ÆµéÀÔ´Ï´Ù. ´Ù¸¥ ÇüÅÂÀÇ ÇÊÅÍ ÀμöÀÇ ÇØ¼®ÀÌ ÀÖ´Â °æ¿ì, ÇØ¼®Àº ±× µð·ºÅ丮ÀÇ ¼ºñ½º ÇÁ·Î¹ÙÀÌ´õ¿¡ ÇØ ÆÇº°µÇ¾î ¼ºñ½º ÇÁ·Î¹ÙÀÌ´õ´Â ÇÊÅÍ Á¶ÀÛÀ», ÇØ´çÇÏ´Â ½Ã¸àƽ½º¿Í ÇÔ²² ±âº»ÀÌ µÇ´Â µð·ºÅ丮ÀÇ Á¶ÀÛ¿¡ ¸Ê ÇÕ´Ï´Ù.
ÀÌ ¸Þ¼µå´Â °á°úÀÇ ¿°Å¸¦ µ¹·ÁÁÝ´Ï´Ù. ¿°ÅÀÇ °¢ ¿ä¼Ò´Â
¿ÀºêÁ§Æ®ÀÇ À̸§ ±× ¿Ü ¿ÀºêÁ§Æ®¿¡ °üÇÑ Á¤º¸¸¦ Æ÷ÇÔÇϰí ÀÖ½À´Ï´Ù (SearchResult
ÂüÁ¶). À̸§Àº, (name
ÆÄ¶ó¹ÌÅÍ¿¡
ÇØ À̸§ÀÌ ºÙ¿©Áø) °Ë»öÀÇ Å¸°Ù ÄÁÅØ½ºÆ®
¿¡ °ü·ÃÇϰí ÀÖ´ÂÁö, URL ij¸¯ÅÍ ¶óÀÎÀϱîÀÇ ¾î´À ÂÊÀÎÁöÀÔ´Ï´Ù. cons
°¡ SearchControls.OBJECT_SCOPE
¶Ç´Â SearchControls.SUBSTREE_SCOPE
°Ë»ö ¹üÀ§¸¦ ÁöÁ¤ÇÏ´Â °æ¿ì¿¡ »ý°¢µÇµµ·Ï, Ÿ°Ù ÄÁÅØ½ºÆ®
ÀÌ ¿°Å¿¡ Æ÷ÇԵǴ °æ¿ì, ±× À̸§Àº ÇÏ´ÃÀÇ Ä³¸¯ÅÍ ¶óÀÎÀÔ´Ï´Ù.
¼Ó¼ºÀ» µ¹·ÁÁÖµµ·Ï(µíÀÌ) cons Àμö°¡ ÁöÁ¤ÇßÀ» °æ¿ì,SearchResult´Â ÀÏÄ¡ÇÏ´Â ¿ÀºêÁ§Æ®ÀÇ ¼Ó¼ºµµ Æ÷ÇÔÇÏ´Â ÀÏÀÌ ÀÖ½À´Ï´Ù.
¿ä±¸µÈ ¼Ó¼ºÀ» ¿ÀºêÁ§Æ®°¡ °¡Áö°í ÀÖÁö ¾ÊÀº °æ¿ì, ±× Á¸ÀçÇÏÁö ¾Ê´Â ¼Ó¼ºÀº ¹«½ÃµË´Ï´Ù. ¿ÀºêÁ§Æ®°¡ °¡Áö°í ÀÖ´Â ¿ä±¸µÈ ¼Ó¼ºÀÌ µ¹·ÁÁÖ°íÁý´Ï´Ù.
µð·ºÅ丮´Â ¿ä±¸µÈ ÀÌ»óÀÇ ¼öÀÇ ¼Ó¼ºÀ» µ¹·ÁÁÖ´Â ÀÏÀÌ ÀÖ½À´Ï´Ù (Ŭ·¡½ºÀÇ ¼³¸íÀÇ¡¸¼Ó¼ºÇü¸í¡¹ ÂüÁ¶)°¡, ¹«°ü°èÇÑ ÀÓÀÇÀÇ ¼Ó¼ºÀ» µ¹·ÁÁÙ °ÍÀº ¾ø½À´Ï´Ù.
¹«È¿ÀÎ º¯¼öÀÇ Ä¡È¯À» ½Ç½ÃÇÏ´Â °Ë»ö ÇÊÅͰ¡ ÀÌ ¸Þ¼µå¿¡ Á¦°øµÇ¾úÀ» °æ¿ì, °á°ú´Â Á¤Àǵǰí ÀÖÁö ¾Ê½À´Ï´Ù. ÀÌ DirContext ·Î º¯°æÀÌ ÀÌ·ç¾îÁ³À» °æ¿ì, ÀÌ ¸Þ¼µå¿¡ ´ëÇÑ º¯°æÀüÀÇ È£Ãâ¿¡ ÇØ µ¹·ÁÁÖ°íÁö´Â ¿°ÅÀÇ °á°ú´Â Á¤Àǵǰí ÀÖÁö ¾Ê½À´Ï´Ù.
Ŭ·¡½ºÀÇ ¼³¸íÀÇ¡¸Á¶ÀÛ ¼Ó¼º¡¹ µµ ÂüÁ¶ÇϽʽÿÀ.
DirContext
³»ÀÇ search
name
- °Ë»öÇÏ´Â ÄÁÅØ½ºÆ®
¶Ç´Â ¿ÀºêÁ§Æ®ÀÇ À̸§filterExpr
- °Ë»ö¿¡ »ç¿ëÇÏ´Â ÇÊÅͽÄ. ½Ä¿¡´Â Æû ¡¸{i}
¡¹ÀÇ º¯¼ö¸¦ Æ÷ÇÔÇÒ ¼ö°¡ ÀÖ´Ù. i
´Â
ºÎ°¡ ¾Æ´Ñ Á¤¼ö. null´Â
ºÒ°¡filterArgs
- filterExpr
º¯¼ö¸¦ ġȯÇÏ´Â ÀμöÀÇ ¹è¿. filterArgs[i]
°ªÀÌ °¢ ¡¸{i}
¡¹¸¦ ġȯÇÑ´Ù. null
°æ¿ì, ÇÏ´ÃÀÇ ¹è¿°ú µ¿µîcons
- °Ë»öÀ» Á¦¾îÇÏ´Â °Ë»ö Á¦¾î. null
°æ¿ì, µðÆúÆ®ÀÇ °Ë»ö Á¦¾î°¡ »ç¿ëµÈ´Ù ((new SearchControls()) ¿Í µ¿µî)
InvalidSearchControlsException
- cons °¡ ¹«È¿ÀÎ ¼³Á¤À» Æ÷ÇÔÇϰí ÀÖ´Â °æ¿ì
InvalidSearchFilterException
- filterArgs¸¦
°¡Áö´Â filterExpr °¡ ¹«È¿ÀÎ °Ë»ö ÇÊÅ͸¦ ³ªÅ¸³»°í ÀÖ´Â °æ¿ì
NamingException
- ³×ÀÌ¹Ö ¿¹¿Ü°¡ ¹ß»ýÇßÀ» °æ¿ìDirContext.search(Name, Attributes, String[])
,
MessageFormat
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
ÀÌÀü Ŭ·¡½º ´ÙÀ½ Ŭ·¡½º | ÇÁ·¹ÀÓÀ¸·Î ÇÁ·¹ÀÓ ¾øÀÌ | |||||||||
°³¿ä: NESTED | Çʵå | constructor | ¸Þ¼µå | »ó¼¼: Çʵå | »ý¼ºÀÚ | ¸Þ¼µå |
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy µµ ÂüÁ¶ÇϽʽÿÀ.