echelon/i2p.i2p
1
0
Fork 0
forked from I2P_Developers/i2p.i2p
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

javadoc

Browse Source
This commit is contained in:
zzz
2011-05-23 19:16:33 +00:00
parent 4ea5622842
commit 7ab95d0144
21 changed files with 79 additions and 74 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
core/java/src/net/i2p/client/naming/BlockfileNamingService.java
View File

@ -70,6 +70,8 @@ import net.metanotion.util.skiplist.SkipList;
* </pre>
*
* All host names are converted to lower case.
*
* @since 0.8.7
*/
public class BlockfileNamingService extends DummyNamingService {

2
core/java/src/net/i2p/client/naming/DummyNamingService.java
View File

@ -86,7 +86,7 @@ class DummyNamingService extends NamingService {
}
}
/** @since 0.8.5 */
/** @since 0.8.7 */
protected static void removeCache(String s) {
synchronized (_cache) {
_cache.remove(s);

2
core/java/src/net/i2p/client/naming/MetaNamingService.java
View File

@ -49,7 +49,7 @@ public class MetaNamingService extends DummyNamingService {
/**
* @param services if non-null, services to be added. If null, this will only handle b32 and b64,
* until addNamingService() is called later.
* @since 0.8.5
* @since 0.8.7
*/
public MetaNamingService(I2PAppContext context, List<NamingService> services) {
super(context);

64
core/java/src/net/i2p/client/naming/NamingService.java
View File

@ -97,7 +97,7 @@ public abstract class NamingService {
/**
* @return Class simple name by default
* @since 0.8.5
* @since 0.8.7
*/
public String getName() {
return getClass().getSimpleName();
@ -105,7 +105,7 @@ public abstract class NamingService {
/**
* @return NamingService-specific options or null
* @since 0.8.5
* @since 0.8.7
*/
public Properties getConfiguration() {
return null;
@ -113,7 +113,7 @@ public abstract class NamingService {
/**
* @return success
* @since 0.8.5
* @since 0.8.7
*/
public boolean setConfiguration(Properties p) {
return true;
@ -123,7 +123,7 @@ public abstract class NamingService {
/**
* @return chained naming services or null
* @since 0.8.5
* @since 0.8.7
*/
public List<NamingService> getNamingServices() {
return null;
@ -131,7 +131,7 @@ public abstract class NamingService {
/**
* @return parent naming service or null if this is the root
* @since 0.8.5
* @since 0.8.7
*/
public NamingService getParent() {
return null;
@ -158,7 +158,7 @@ public abstract class NamingService {
/**
* Only for chaining-capable NamingServices
* @return success
* @since 0.8.5
* @since 0.8.7
*/
public boolean removeNamingService(NamingService ns) {
return false;
@ -170,7 +170,7 @@ public abstract class NamingService {
/**
* @return number of entries or -1 if unknown
* @since 0.8.5
* @since 0.8.7
*/
public int size() {
return size(null);
@ -179,7 +179,7 @@ public abstract class NamingService {
/**
* @param options NamingService-specific, can be null
* @return number of entries (matching the options if non-null) or -1 if unknown
* @since 0.8.5
* @since 0.8.7
*/
public int size(Properties options) {
return -1;
@ -189,7 +189,7 @@ public abstract class NamingService {
* @return all mappings
* or empty Map if none;
* Returned Map is not necessarily sorted, implementation dependent
* @since 0.8.5
* @since 0.8.7
*/
public Map<String, Destination> getEntries() {
return getEntries(null);
@ -200,7 +200,7 @@ public abstract class NamingService {
* @return all mappings (matching the options if non-null)
* or empty Map if none;
* Returned Map is not necessarily sorted, implementation dependent
* @since 0.8.5
* @since 0.8.7
*/
public Map<String, Destination> getEntries(Properties options) {
return Collections.EMPTY_MAP;
@ -212,7 +212,7 @@ public abstract class NamingService {
* @return all mappings (matching the options if non-null)
* or empty Map if none;
* Returned Map is not necessarily sorted, implementation dependent
* @since 0.8.5
* @since 0.8.7
*/
public Map<String, String> getBase64Entries(Properties options) {
return Collections.EMPTY_MAP;
@ -222,7 +222,7 @@ public abstract class NamingService {
* @return all known host names
* or empty Set if none;
* Returned Set is not necessarily sorted, implementation dependent
* @since 0.8.5
* @since 0.8.7
*/
public Set<String> getNames() {
return getNames(null);
@ -233,7 +233,7 @@ public abstract class NamingService {
* @return all known host names (matching the options if non-null)
* or empty Set if none;
* Returned Set is not necessarily sorted, implementation dependent
* @since 0.8.5
* @since 0.8.7
*/
public Set<String> getNames(Properties options) {
return Collections.EMPTY_SET;
@ -241,7 +241,7 @@ public abstract class NamingService {
/**
* @return success
* @since 0.8.5
* @since 0.8.7
*/
public boolean put(String hostname, Destination d) {
return put(hostname, d, null);
@ -250,7 +250,7 @@ public abstract class NamingService {
/**
* @param options NamingService-specific, can be null
* @return success
* @since 0.8.5
* @since 0.8.7
*/
public boolean put(String hostname, Destination d, Properties options) {
return false;
@ -259,7 +259,7 @@ public abstract class NamingService {
/**
* Fails if entry previously exists
* @return success
* @since 0.8.5
* @since 0.8.7
*/
public boolean putIfAbsent(String hostname, Destination d) {
return putIfAbsent(hostname, d, null);
@ -269,7 +269,7 @@ public abstract class NamingService {
* Fails if entry previously exists
* @param options NamingService-specific, can be null
* @return success
* @since 0.8.5
* @since 0.8.7
*/
public boolean putIfAbsent(String hostname, Destination d, Properties options) {
return false;
@ -278,7 +278,7 @@ public abstract class NamingService {
/**
* @param options NamingService-specific, can be null
* @return success
* @since 0.8.5
* @since 0.8.7
*/
public boolean putAll(Map<String, Destination> entries, Properties options) {
boolean rv = true;
@ -294,7 +294,7 @@ public abstract class NamingService {
* @param d may be null if only options are changing
* @param options NamingService-specific, can be null
* @return success
* @since 0.8.5
* @since 0.8.7
*/
public boolean update(String hostname, Destination d, Properties options) {
return false;
@ -302,7 +302,7 @@ public abstract class NamingService {
/**
* @return success
* @since 0.8.5
* @since 0.8.7
*/
public boolean remove(String hostname) {
return remove(hostname, null);
@ -311,7 +311,7 @@ public abstract class NamingService {
/**
* @param options NamingService-specific, can be null
* @return success
* @since 0.8.5
* @since 0.8.7
*/
public boolean remove(String hostname, Properties options) {
return false;
@ -320,7 +320,7 @@ public abstract class NamingService {
/**
* Ask any registered updaters to update now
* @param options NamingService- or updater-specific, may be null
* @since 0.8.5
* @since 0.8.7
*/
public void requestUpdate(Properties options) {
for (NamingServiceUpdater nsu : _updaters) {
@ -329,28 +329,28 @@ public abstract class NamingService {
}
/**
* @since 0.8.5
* @since 0.8.7
*/
public void registerListener(NamingServiceListener nsl) {
_listeners.add(nsl);
}
/**
* @since 0.8.5
* @since 0.8.7
*/
public void unregisterListener(NamingServiceListener nsl) {
_listeners.remove(nsl);
}
/**
* @since 0.8.6
* @since 0.8.7
*/
public void registerUpdater(NamingServiceUpdater nsu) {
_updaters.add(nsu);
}
/**
* @since 0.8.6
* @since 0.8.7
*/
public void unregisterUpdater(NamingServiceUpdater nsu) {
_updaters.remove(nsu);
@ -363,7 +363,7 @@ public abstract class NamingService {
* @param lookupOptions input parameter, NamingService-specific, can be null
* @param storedOptions output parameter, NamingService-specific, any stored properties will be added if non-null
* @return dest or null
* @since 0.8.5
* @since 0.8.7
*/
public abstract Destination lookup(String hostname, Properties lookupOptions, Properties storedOptions);
@ -371,7 +371,7 @@ public abstract class NamingService {
* Same as reverseLookup(dest) but with options
* @param options NamingService-specific, can be null
* @return host name or null
* @since 0.8.5
* @since 0.8.7
*/
public String reverseLookup(Destination d, Properties options) {
return null;
@ -383,7 +383,7 @@ public abstract class NamingService {
* @param hostname must be {52 chars}.b32.i2p
* @param timeout in seconds; <= 0 means use router default
* @return dest or null
* @since 0.8.5
* @since 0.8.7
*/
public Destination lookupBase32(String hostname, int timeout) {
return null;
@ -393,7 +393,7 @@ public abstract class NamingService {
* Same as lookupB32 but with the SHA256 Hash precalculated
* @param timeout in seconds; <= 0 means use router default
* @return dest or null
* @since 0.8.5
* @since 0.8.7
*/
public Destination lookup(Hash hash, int timeout) {
return null;
@ -403,7 +403,7 @@ public abstract class NamingService {
* Parent will call when added.
* If this is the root naming service, the core will start it.
* Should not be called by others.
* @since 0.8.5
* @since 0.8.7
*/
public void start() {}
@ -411,7 +411,7 @@ public abstract class NamingService {
* Parent will call when removed.
* If this is the root naming service, the core will stop it.
* Should not be called by others.
* @since 0.8.5
* @since 0.8.7
*/
public void shutdown() {}

2
core/java/src/net/i2p/client/naming/NamingServiceListener.java
View File

@ -5,7 +5,7 @@ import java.util.Properties;
import net.i2p.data.Destination;
/**
* @since 0.8.6
* @since 0.8.7
*/
public interface NamingServiceListener {

2
core/java/src/net/i2p/client/naming/NamingServiceUpdater.java
View File

@ -3,7 +3,7 @@ package net.i2p.client.naming;
import java.util.Properties;
/**
* @since 0.8.6
* @since 0.8.7
*/
public interface NamingServiceUpdater {

2
core/java/src/net/i2p/client/naming/SingleFileNamingService.java
View File

@ -47,7 +47,7 @@ import net.i2p.util.SecureFileOutputStream;
* Use from HostsTxtNamingService or chain with another NamingService
* via MetaNamingService if you need those features.
*
* @since 0.8.5
* @since 0.8.7
*/
public class SingleFileNamingService extends NamingService {

2
core/java/src/net/i2p/data/DataHelper.java
View File

@ -165,7 +165,7 @@ public class DataHelper {
* Use utf8 = true for SessionConfig (slow, UTF-8)
* @param props source may be null
* @param sort should we sort the properties? (set to false if already sorted, e.g. OrderedProperties)
* @since 0.8.6
* @since 0.8.7
*/
public static void writeProperties(OutputStream rawStream, Properties props, boolean utf8, boolean sort)
throws DataFormatException, IOException {

4
core/java/src/net/i2p/stat/StatManager.java
View File

@ -89,7 +89,7 @@ public class StatManager {
* @param description simple description of the statistic
* @param group used to group statistics together
* @param periods array of period lengths (in milliseconds)
* @since 0.8.6
* @since 0.8.7
*/
public void createRequiredFrequencyStat(String name, String description, String group, long periods[]) {
if (_frequencyStats.containsKey(name)) return;
@ -118,7 +118,7 @@ public class StatManager {
* @param description simple description of the statistic
* @param group used to group statistics together
* @param periods array of period lengths (in milliseconds)
* @since 0.8.6
* @since 0.8.7
*/
public void createRequiredRateStat(String name, String description, String group, long periods[]) {
if (_rateStats.containsKey(name)) return;

9
core/java/src/net/i2p/util/EepPost.java
View File

@ -17,6 +17,7 @@ import net.i2p.I2PAppContext;
/**
* Simple helper for uploading files and such via HTTP POST (rfc 1867)
*
* @deprecated unused
*/
public class EepPost {
private I2PAppContext _context;
@ -209,10 +210,10 @@ public class EepPost {
}
private String getSeparator() {
if (false)
return "ABCDEFG";
if (false)
return "------------------------" + new java.util.Random().nextLong();
//if (false)
// return "ABCDEFG";
//if (false)
// return "------------------------" + new java.util.Random().nextLong();
byte separator[] = new byte[32]; // 2^-128 chance of this being a problem
I2PAppContext.getGlobalContext().random().nextBytes(separator);
StringBuilder sep = new StringBuilder(48);

2
core/java/src/net/i2p/util/HTTPSendData.java
View File

@ -75,6 +75,7 @@ public class HTTPSendData {
}
}
/****
public static void main(String args[]) {
byte data[] = new byte[4096];
for (int i = 0; i < data.length; i++)
@ -88,4 +89,5 @@ public class HTTPSendData {
} catch (InterruptedException ie) { // nop
}
}
****/
}