|
Server : Apache/2.2.2 (Fedora) System : Linux App1.pathumtani.go.th 2.6.20-1.2320.fc5smp #1 SMP Tue Jun 12 19:40:16 EDT 2007 i686 User : apache ( 48) PHP Version : 5.2.9 Disable Function : NONE Directory : /usr/share/javadoc/cryptix-3.2.0/xjava/security/ |
Upload File : |
<?xml version="1.0" encoding="US-ASCII"?>
<!DOCTYPE html PUBLIC "-//gnu.org///DTD XHTML 1.1 plus Target 1.0//EN" "../../resources/xhtml11-target10.dtd"><html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><title>Padding (cryptix JavaDoc)</title><script src="../../resources/gjdoc.js" type="text/javascript"><!-- this comment required for konqueror 3.2.2 --></script><meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"/><meta name="generator" content="GNU Gjdoc Standard Doclet"/><meta name="keywords" content="xjava.security.Padding class"/><meta name="keywords" content="pad()"/><meta name="keywords" content="unpad()"/><meta name="keywords" content="padLength()"/><meta name="keywords" content="paddingScheme()"/><link rel="stylesheet" type="text/css" href="../../resources/gjdochtml-clean-layout.css" title="GNU Clean"/><link rel="stylesheet" type="text/css" href="../../resources/gjdochtml-clean-color1.css" title="GNU Clean"/></head><body class="content class" onload="if(parent.contentPageLoaded)parent.contentPageLoaded(document.title)"><table class="navbar div top"><tr><td class="navbar div top"><div class="navbar div top"><span class="navbar item enabled"><a href="../../overview-summary.html">Overview</a></span> <span class="navbar item enabled"><a href="package-summary.html">Package</a></span> <span class="navbar item enabled"><a href="tree.html">Tree</a></span> <span class="navbar item enabled"><a href="../../alphaindex.html">Index</a></span> <span class="navbar item enabled"><a href="../../deprecated.html">Deprecated</a></span> <span class="navbar item enabled"><a href="../../about.html">About</a></span></div></td></tr><tr><td class="navi"><a href="../../xjava/security/NoSuchParameterException.html">Prev Class</a> | <a href="../../xjava/security/PaddingScheme.html">Next Class</a></td><td class="navi"><a href="../../index.html" title="Show in a frameset" target="_top">Frames</a> | <a href="Padding.html" title="Show without frames" target="_top">No Frames</a> </td></tr><tr><td class="navi">Summary: Nested | Field | <a href="#summary-methods">Method</a> | Constr</td><td class="navi">Detail: Nested | Field | <a href="#detail-methods">Method</a> | Constr</td></tr></table><div class="class title outer"><h3 class="class title-package">xjava.security</h3><h1 class="class title-class">Interface Padding</h1></div><dl class="class knownimplementing"><dt class="header"><b>Known Implementing Classes:</b></dt><dd class="item"><a href="../../cryptix/provider/padding/OneAndZeroes.html" title="Class in cryptix.provider.padding">OneAndZeroes</a>, <a href="../../xjava/security/PaddingScheme.html" title="Class in xjava.security">PaddingScheme</a>, <a href="../../cryptix/provider/padding/PKCS5.html" title="Class in cryptix.provider.padding">PKCS5</a>, <a href="../../cryptix/provider/padding/PKCS7.html" title="Class in cryptix.provider.padding">PKCS7</a></dd></dl><hr/><div class="class synopsis outer"><div class="class synopsis declaration"><code>public interface <b class="class synopsis name">Padding</b></code></div></div><hr/><div class="class description"> Padding is the interface defined by JavaSoft's JCE to be implemented
by classes that provide a general-purpose padding scheme. It is not
used in IJCE, for several reasons:
<ul><li> Interfaces are more difficult to extend with new functionality
than abstract classes (for an abstract class, new methods can
be given default implementations that are defined in terms of
existing methods).
<p/>
</li><li> An abstract class can enforce that SPI methods are called
with valid arguments; an interface cannot.
<p/>
</li><li> The Padding interface does not support arbitrary block sizes. Each
padding scheme must be defined for a specific block size.
<p/>
</li><li> The documentation for Padding was not clear enough to re-implement
accurately.
<p/>
</li><li> The Security.getImpl method in JavaSoft's implementation of
JCE does not work correctly for interfaces.
</li></ul>
<p/>
This interface is included in IJCE only so that classes that use it
will not fail with an unrecoverable linking error. The abstract class
PaddingScheme should be used instead.
<p/>
<b>Copyright</b> © 1997
<a href="http://www.systemics.com/">Systemics Ltd</a> on behalf of the
<a href="http://www.systemics.com/docs/cryptix/">Cryptix Development Team</a>.
<br/>All rights reserved.
<p/><b>$Revision: 1.2 $</b>
</div><div class="taglet"><dl class="tag list"><dt class="tag section header"><b>Author:</b></dt><dd class="tag item">David Hopwood</dd></dl></div><div class="taglet"><dl class="tag list"><dt class="tag section header"><b>Since:</b></dt><dd>IJCE 1.0.0</dd></dl></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"><dl class="tag list"><dt class="tag section header"><b>See Also:</b></dt><dd><code>java.security.PaddingScheme</code></dd></dl></div><div class="taglet"></div><div class="taglet"></div><a name="summary-methods" id="summary-methods"/><dl class="table container"><dd><table class="class summary" border="1" width="100%"><tr class="table header"><td colspan="2"><h2 class="table header">Method Summary</h2></td></tr><tr><td class="left" valign="top"><code class="synopsis"> int</code></td><td class="right"><dl class="list"><dt class="synopsis"><code><a href="#pad(in[],int,int)">pad</a>(in[] , int off, int len)</code></dt><dd class="description"> Pads a given array of bytes.</dd></dl></td></tr><tr><td class="left" valign="top"><code class="synopsis"> int</code></td><td class="right"><dl class="list"><dt class="synopsis"><code><a href="#padLength(int)">padLength</a>(int len)</code></dt><dd class="description"> Returns the absolute value of the increase in size that a
padding operation would cause on input data of a given length.</dd></dl></td></tr><tr><td class="left" valign="top"><code class="synopsis"> String</code></td><td class="right"><dl class="list"><dt class="synopsis"><code><a href="#paddingScheme()">paddingScheme</a>()</code></dt><dd class="description"> Returns the standard name of the padding scheme implemented.</dd></dl></td></tr><tr><td class="left" valign="top"><code class="synopsis"> int</code></td><td class="right"><dl class="list"><dt class="synopsis"><code><a href="#unpad(in[],int,int)">unpad</a>(in[] , int off, int len)</code></dt><dd class="description"> Given the specified subarray of bytes that includes padding
bytes, returns the index indicating where padding starts.</dd></dl></td></tr></table></dd></dl><a name="detail-methods" id="detail-methods"/><h2 class="section header">Method Details</h2><div class="section"><a name="pad(in[],int,int)" id="pad(in[],int,int)"/><div class="member detail outer"><h3 class="member detail name">pad</h3><pre class="member detail synopsis">public int pad(in[] ,
int off,
int len)</pre><blockquote class="member detail name"><div class="member detail description"> Pads a given array of bytes. The padded bytes are written to the
same buffer that is used for input ("in").
</div><div class="parameter"><dl><dt class="header"><b>Parameters:</b></dt><dd class="item"><code class="name">off</code><span class="separator"> - </span><span class="description">the offset into the <code>in</code> buffer of the
first byte in the group of bytes to be padded.</span></dd><dd class="item"><code class="name">len</code><span class="separator"> - </span><span class="description">the number of bytes from the <code>in</code> buffer,
starting at <code>off</code>, that need to be padded.</span></dd></dl></div><div class="member detail return list"><dl><dt class="member detail return header"><b>Returns:</b></dt><dd class="member detail return item">the number of padding bytes written.</dd></dl></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"><dl class="tag list"><dt class="tag section header"><b>See Also:</b></dt><dd><code>java.security.Cipher.blockSize</code></dd></dl></div><div class="taglet"></div><div class="taglet"></div></blockquote></div><hr/><a name="padLength(int)" id="padLength(int)"/><div class="member detail outer"><h3 class="member detail name">padLength</h3><pre class="member detail synopsis">public int padLength(int len)</pre><blockquote class="member detail name"><div class="member detail description"> Returns the absolute value of the increase in size that a
padding operation would cause on input data of a given length.
</div><div class="parameter"><dl><dt class="header"><b>Parameters:</b></dt><dd class="item"><code class="name">len</code><span class="separator"> - </span><span class="description">the length of the data which is to be padded.</span></dd></dl></div><div class="member detail return list"><dl><dt class="member detail return header"><b>Returns:</b></dt><dd class="member detail return item">the absolute value of the increase in size that a padding
operation would cause on input data of the specified length.</dd></dl></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div></blockquote></div><hr/><a name="paddingScheme()" id="paddingScheme()"/><div class="member detail outer"><h3 class="member detail name">paddingScheme</h3><pre class="member detail synopsis">public String paddingScheme()</pre><blockquote class="member detail name"><div class="member detail description"> Returns the standard name of the padding scheme implemented.
<p/>
See <a href="../guide/ijce/Algorithms.html#PaddingScheme">
<cite>International JCE Standard Algorithm Names</cite></a> for a list
of PaddingScheme algorithm names.
</div><div class="member detail return list"><dl><dt class="member detail return header"><b>Returns:</b></dt><dd class="member detail return item">the standard name of the padding scheme, such as "PKCS#5".</dd></dl></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div></blockquote></div><hr/><a name="unpad(in[],int,int)" id="unpad(in[],int,int)"/><div class="member detail outer"><h3 class="member detail name">unpad</h3><pre class="member detail synopsis">public int unpad(in[] ,
int off,
int len)</pre><blockquote class="member detail name"><div class="member detail description"> Given the specified subarray of bytes that includes padding
bytes, returns the index indicating where padding starts.
</div><div class="parameter"><dl><dt class="header"><b>Parameters:</b></dt><dd class="item"><code class="name">off</code><span class="separator"> - </span><span class="description">the starting offset into the <code>in</code> buffer of
the bytes to be checked to determine where padding starts.</span></dd><dd class="item"><code class="name">len</code><span class="separator"> - </span><span class="description">the number of bytes from the <code>in</code> buffer
to check, starting at offset <code>off</code>.</span></dd></dl></div><div class="member detail return list"><dl><dt class="member detail return header"><b>Returns:</b></dt><dd class="member detail return item">the index into the <code>in</code> buffer indicating
where the padding starts.</dd></dl></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div><div class="taglet"></div></blockquote></div></div><p class="navbar bottom spacer"> </p><table class="navbar div bottom"><tr><td><div class="navbar div top"><span class="navbar item enabled"><a href="../../overview-summary.html">Overview</a></span> <span class="navbar item enabled"><a href="package-summary.html">Package</a></span> <span class="navbar item enabled"><a href="tree.html">Tree</a></span> <span class="navbar item enabled"><a href="../../alphaindex.html">Index</a></span> <span class="navbar item enabled"><a href="../../deprecated.html">Deprecated</a></span> <span class="navbar item enabled"><a href="../../about.html">About</a></span></div></td></tr></table></body></html>