uTools-Manuals/docs/java/javax/naming/directory/AttributeModificationException.html

277 lines
16 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
compact3
</div>
<div class="subTitle">
javax.naming.directory
</div>
<h2 class="title" title="Class AttributeModificationException">Class AttributeModificationException</h2>
</div><div class="contentContainer">
<ul class="inheritance">
<li><a href="../../../java/lang/Object.html" title="class in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li><a href="../../../java/lang/Throwable.html" title="class in java.lang">java.lang.Throwable</a></li>
<li>
<ul class="inheritance">
<li><a href="../../../java/lang/Exception.html" title="class in java.lang">java.lang.Exception</a></li>
<li>
<ul class="inheritance">
<li><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">javax.naming.NamingException</a></li>
<li>
<ul class="inheritance">
<li>javax.naming.directory.AttributeModificationException</li>
</ul> </li>
</ul> </li>
</ul> </li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Implemented Interfaces:
</dt>
<dd>
<span><a href="../../../java/io/Serializable.html" title="java.io中的接口">Serializable</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public class <span class="typeNameLabel">AttributeModificationException</span>
extends <a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></pre>
<div class="block">
<span>当尝试添加,删除或修改与属性(模式)定义或属性状态冲突的属性,其标识符或其值时,会抛出此异常。</span>
<span>它被抛出以响应DirContext.modifyAttributes</span>
<span>它包含未被执行的修改列表按照它们提供给modifyAttributes的顺序。</span>
<span>如果列表为空,则不会成功执行任何修改。</span>
<p> <span>AttributeModificationException实例与并发多线程访问不同步。</span> <span>尝试访问和修改单个AttributeModification实例的多个线程应锁定该对象。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.3
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/naming/directory/DirContext.html#modifyAttributes-javax.naming.Name-int-javax.naming.directory.Attributes-"><code>DirContext.modifyAttributes(javax.naming.Name, int, javax.naming.directory.Attributes)</code></a>
<a href="../../../serialized-form.html#javax.naming.directory.AttributeModificationException">Serialized Form</a>
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.summary">
<!-- --> </a> <h3>Field Summary</h3>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.javax.naming.NamingException">
<!-- --> </a> <h3>Fields inherited from class javax.naming.<a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></h3> <code><a href="../../../javax/naming/NamingException.html#remainingName">remainingName</a>, <a href="../../../javax/naming/NamingException.html#resolvedName">resolvedName</a>, <a href="../../../javax/naming/NamingException.html#resolvedObj">resolvedObj</a>, <a href="../../../javax/naming/NamingException.html#rootException">rootException</a></code></li>
</ul> </li>
</ul>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- --> </a> <h3>构造方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Constructor Summary table, listing constructors, and an explanation">
<caption>
<span>构造方法</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/AttributeModificationException.html#AttributeModificationException--">AttributeModificationException</a></span>()</code>
<div class="block">
构造一个新的AttributeModificationException实例。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/AttributeModificationException.html#AttributeModificationException-java.lang.String-">AttributeModificationException</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> explanation)</code>
<div class="block">
使用说明构造一个新的AttributeModificationException实例。
</div> </td>
</tr>
</tbody>
</table> </li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t4"><span><a href="javascript:show(8);">具体的方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code><a href="../../../javax/naming/directory/ModificationItem.html" title="class in javax.naming.directory">ModificationItem</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/AttributeModificationException.html#getUnexecutedModifications--">getUnexecutedModifications</a></span>()</code>
<div class="block">
检索未执行的修改列表。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/AttributeModificationException.html#setUnexecutedModifications-javax.naming.directory.ModificationItem:A-">setUnexecutedModifications</a></span>(<a href="../../../javax/naming/directory/ModificationItem.html" title="class in javax.naming.directory">ModificationItem</a>[] e)</code>
<div class="block">
将未执行的修改列表设置为e。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/naming/directory/AttributeModificationException.html#toString--">toString</a></span>()</code>
<div class="block">
此异常的字符串表示形式包含有关错误发生位置的信息和第一个未执行的修改。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.naming.NamingException">
<!-- --> </a> <h3>Methods inherited from class javax.naming.<a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></h3> <code><a href="../../../javax/naming/NamingException.html#appendRemainingComponent-java.lang.String-">appendRemainingComponent</a>, <a href="../../../javax/naming/NamingException.html#appendRemainingName-javax.naming.Name-">appendRemainingName</a>, <a href="../../../javax/naming/NamingException.html#getCause--">getCause</a>, <a href="../../../javax/naming/NamingException.html#getExplanation--">getExplanation</a>, <a href="../../../javax/naming/NamingException.html#getRemainingName--">getRemainingName</a>, <a href="../../../javax/naming/NamingException.html#getResolvedName--">getResolvedName</a>, <a href="../../../javax/naming/NamingException.html#getResolvedObj--">getResolvedObj</a>, <a href="../../../javax/naming/NamingException.html#getRootCause--">getRootCause</a>, <a href="../../../javax/naming/NamingException.html#initCause-java.lang.Throwable-">initCause</a>, <a href="../../../javax/naming/NamingException.html#setRemainingName-javax.naming.Name-">setRemainingName</a>, <a href="../../../javax/naming/NamingException.html#setResolvedName-javax.naming.Name-">setResolvedName</a>, <a href="../../../javax/naming/NamingException.html#setResolvedObj-java.lang.Object-">setResolvedObj</a>, <a href="../../../javax/naming/NamingException.html#setRootCause-java.lang.Throwable-">setRootCause</a>, <a href="../../../javax/naming/NamingException.html#toString-boolean-">toString</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Throwable">
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../../java/lang/Throwable.html" title="class in java.lang">Throwable</a></h3> <code><a href="../../../java/lang/Throwable.html#addSuppressed-java.lang.Throwable-">addSuppressed</a>, <a href="../../../java/lang/Throwable.html#fillInStackTrace--">fillInStackTrace</a>, <a href="../../../java/lang/Throwable.html#getLocalizedMessage--">getLocalizedMessage</a>, <a href="../../../java/lang/Throwable.html#getMessage--">getMessage</a>, <a href="../../../java/lang/Throwable.html#getStackTrace--">getStackTrace</a>, <a href="../../../java/lang/Throwable.html#getSuppressed--">getSuppressed</a>, <a href="../../../java/lang/Throwable.html#printStackTrace--">printStackTrace</a>, <a href="../../../java/lang/Throwable.html#printStackTrace-java.io.PrintStream-">printStackTrace</a>, <a href="../../../java/lang/Throwable.html#printStackTrace-java.io.PrintWriter-">printStackTrace</a>, <a href="../../../java/lang/Throwable.html#setStackTrace-java.lang.StackTraceElement:A-">setStackTrace</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></h3> <code><a href="../../../java/lang/Object.html#clone--">clone</a>, <a href="../../../java/lang/Object.html#equals-java.lang.Object-">equals</a>, <a href="../../../java/lang/Object.html#finalize--">finalize</a>, <a href="../../../java/lang/Object.html#getClass--">getClass</a>, <a href="../../../java/lang/Object.html#hashCode--">hashCode</a>, <a href="../../../java/lang/Object.html#notify--">notify</a>, <a href="../../../java/lang/Object.html#notifyAll--">notifyAll</a>, <a href="../../../java/lang/Object.html#wait--">wait</a>, <a href="../../../java/lang/Object.html#wait-long-">wait</a>, <a href="../../../java/lang/Object.html#wait-long-int-">wait</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="AttributeModificationException-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>AttributeModificationException</h4> <pre>public AttributeModificationException(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> explanation)</pre>
<div class="block">
<span>使用说明构造一个新的AttributeModificationException实例。</span>
<span>所有其他字段都设置为null。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>explanation</code> - 可能是关于此异常的额外详细信息。</span>
<span>如果为空,则此异常没有详细消息。</span>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../java/lang/Throwable.html#getMessage--"><code>Throwable.getMessage()</code></a>
</dd>
</dl> </li>
</ul> <a name="AttributeModificationException--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>AttributeModificationException</h4> <pre>public AttributeModificationException()</pre>
<div class="block">
<span>构造一个新的AttributeModificationException实例。</span>
<span>所有字段都设置为null。</span>
</div> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="setUnexecutedModifications-javax.naming.directory.ModificationItem:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setUnexecutedModifications</h4> <pre>public void setUnexecutedModifications(<a href="../../../javax/naming/directory/ModificationItem.html" title="class in javax.naming.directory">ModificationItem</a>[] e)</pre>
<div class="block">
<span>将未执行的修改列表设置为e。</span>
<span>列表中的项目必须以与DirContext.modifyAttributes中最初提供的顺序相同的顺序显示。</span>
<span>列表中的第一个项目是第一个没有执行的项目。</span>
<span>如果此列表为空则不会执行最初提交给modifyAttributes的操作。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>e</code> -
<code>e</code>的可能的空列表。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/naming/directory/AttributeModificationException.html#getUnexecutedModifications--"><code>getUnexecutedModifications()</code></a>
</dd>
</dl> </li>
</ul> <a name="getUnexecutedModifications--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getUnexecutedModifications</h4> <pre>public <a href="../../../javax/naming/directory/ModificationItem.html" title="class in javax.naming.directory">ModificationItem</a>[] getUnexecutedModifications()</pre>
<div class="block">
<span>检索未执行的修改列表。</span>
<span>列表中的项目以与DirContext.modifyAttributes中最初提供的顺序相同的顺序显示。</span>
<span>列表中的第一个项目是第一个没有执行的项目。</span>
<span>如果此列表为空则不会执行最初提交给modifyAttributes的操作。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
可能为null未执行的修改列表。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/naming/directory/AttributeModificationException.html#setUnexecutedModifications-javax.naming.directory.ModificationItem:A-"><code>setUnexecutedModifications(javax.naming.directory.ModificationItem[])</code></a>
</dd>
</dl> </li>
</ul> <a name="toString--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>toString</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a> toString()</pre>
<div class="block">
<span>此异常的字符串表示形式包含有关错误发生位置的信息和第一个未执行的修改。</span>
<span>此字符串用于调试,而不是以编程方式进行解释。</span>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">重写:</span>
</dt>
<dd>
<code><a href="../../../javax/naming/NamingException.html#toString--">toString</a></code>在类别
<code><a href="../../../javax/naming/NamingException.html" title="class in javax.naming">NamingException</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
此异常的非空字符串表示形式。
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>