src/main/java/net/pterodactylus/sone/core/FreenetInterface.java

   1 /*
   2  * FreenetSone - FreenetInterface.java - Copyright © 2010 David Roden
   3  *
   4  * This program is free software: you can redistribute it and/or modify
   5  * it under the terms of the GNU General Public License as published by
   6  * the Free Software Foundation, either version 3 of the License, or
   7  * (at your option) any later version.
   8  *
   9  * This program is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  * GNU General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU General Public License
  15  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  16  */
  17
  18 package net.pterodactylus.sone.core;
  19
  20 import java.net.MalformedURLException;
  21 import java.util.HashMap;
  22 import java.util.Map;
  23 import java.util.logging.Level;
  24 import java.util.logging.Logger;
  25
  26 import net.pterodactylus.sone.data.Sone;
  27 import net.pterodactylus.util.collection.Pair;
  28 import net.pterodactylus.util.logging.Logging;
  29
  30 import com.db4o.ObjectContainer;
  31
  32 import freenet.client.FetchException;
  33 import freenet.client.FetchResult;
  34 import freenet.client.HighLevelSimpleClient;
  35 import freenet.client.HighLevelSimpleClientImpl;
  36 import freenet.client.InsertException;
  37 import freenet.client.async.ClientContext;
  38 import freenet.client.async.USKCallback;
  39 import freenet.keys.FreenetURI;
  40 import freenet.keys.USK;
  41 import freenet.node.Node;
  42 import freenet.node.RequestStarter;
  43
  44 /**
  45  * Contains all necessary functionality for interacting with the Freenet node.
  46  *
  47  * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
  48  */
  49 public class FreenetInterface {
  50
  51         /** The logger. */
  52         private static final Logger logger = Logging.getLogger(FreenetInterface.class);
  53
  54         /** The node to interact with. */
  55         private final Node node;
  56
  57         /** The high-level client to use for requests. */
  58         private final HighLevelSimpleClient client;
  59
  60         /** The USK callbacks. */
  61         private final Map<String, USKCallback> soneUskCallbacks = new HashMap<String, USKCallback>();
  62
  63         /**
  64          * Creates a new Freenet interface.
  65          *
  66          * @param node
  67          *            The node to interact with
  68          */
  69         public FreenetInterface(Node node) {
  70                 this.node = node;
  71                 this.client = node.clientCore.makeClient(RequestStarter.INTERACTIVE_PRIORITY_CLASS, false, true);
  72         }
  73
  74         //
  75         // ACTIONS
  76         //
  77
  78         /**
  79          * Fetches the given URI.
  80          *
  81          * @param uri
  82          *            The URI to fetch
  83          * @return The result of the fetch, or {@code null} if an error occured
  84          */
  85         public Pair<FreenetURI, FetchResult> fetchUri(FreenetURI uri) {
  86                 FetchResult fetchResult = null;
  87                 FreenetURI currentUri = new FreenetURI(uri);
  88                 while (true) {
  89                         try {
  90                                 fetchResult = client.fetch(currentUri);
  91                                 return new Pair<FreenetURI, FetchResult>(currentUri, fetchResult);
  92                         } catch (FetchException fe1) {
  93                                 if (fe1.getMode() == FetchException.PERMANENT_REDIRECT) {
  94                                         currentUri = fe1.newURI;
  95                                         continue;
  96                                 }
  97                                 logger.log(Level.WARNING, "Could not fetch “" + uri + "”!", fe1);
  98                                 return null;
  99                         }
 100                 }
 101         }
 102
 103         /**
 104          * Creates a key pair.
 105          *
 106          * @return The request key at index 0, the insert key at index 1
 107          */
 108         public String[] generateKeyPair() {
 109                 FreenetURI[] keyPair = client.generateKeyPair("");
 110                 return new String[] { keyPair[1].toString(), keyPair[0].toString() };
 111         }
 112
 113         /**
 114          * Inserts a directory into Freenet.
 115          *
 116          * @param insertUri
 117          *            The insert URI
 118          * @param manifestEntries
 119          *            The directory entries
 120          * @param defaultFile
 121          *            The name of the default file
 122          * @return The generated URI
 123          * @throws SoneException
 124          *             if an insert error occurs
 125          */
 126         public FreenetURI insertDirectory(FreenetURI insertUri, HashMap<String, Object> manifestEntries, String defaultFile) throws SoneException {
 127                 try {
 128                         return client.insertManifest(insertUri, manifestEntries, defaultFile);
 129                 } catch (InsertException ie1) {
 130                         throw new SoneException(null, ie1);
 131                 }
 132         }
 133
 134         /**
 135          * Registers the USK for the given Sone and notifies the given
 136          * {@link SoneDownloader} if an update was found.
 137          *
 138          * @param sone
 139          *            The Sone to watch
 140          * @param soneDownloader
 141          *            The Sone download to notify on updates
 142          */
 143         public void registerUsk(final Sone sone, final SoneDownloader soneDownloader) {
 144                 try {
 145                         logger.log(Level.FINE, "Registering Sone “%s” for USK updates at %s…", new Object[] { sone, sone.getRequestUri().setMetaString(new String[] { "sone.xml" }) });
 146                         USKCallback uskCallback = new USKCallback() {
 147
 148                                 @Override
 149                                 @SuppressWarnings("synthetic-access")
 150                                 public void onFoundEdition(long edition, USK key, ObjectContainer objectContainer, ClientContext clientContext, boolean metadata, short codec, byte[] data, boolean newKnownGood, boolean newSlotToo) {
 151                                         logger.log(Level.FINE, "Found USK update for Sone “%s” at %s, new known good: %s, new slot too: %s.", new Object[] { sone, key, newKnownGood, newSlotToo });
 152                                         if (newKnownGood) {
 153                                                 sone.setLatestEdition(key.suggestedEdition);
 154                                                 new Thread(new Runnable() {
 155
 156                                                         @Override
 157                                                         public void run() {
 158                                                                 soneDownloader.fetchSone(sone);
 159                                                         }
 160                                                 }, "Sone Downloader").start();
 161                                         }
 162                                 }
 163
 164                                 @Override
 165                                 public short getPollingPriorityProgress() {
 166                                         return RequestStarter.INTERACTIVE_PRIORITY_CLASS;
 167                                 }
 168
 169                                 @Override
 170                                 public short getPollingPriorityNormal() {
 171                                         return RequestStarter.INTERACTIVE_PRIORITY_CLASS;
 172                                 }
 173                         };
 174                         soneUskCallbacks.put(sone.getId(), uskCallback);
 175                         node.clientCore.uskManager.subscribe(USK.create(sone.getRequestUri()), uskCallback, true, (HighLevelSimpleClientImpl) client);
 176                 } catch (MalformedURLException mue1) {
 177                         logger.log(Level.WARNING, "Could not subscribe USK “" + sone.getRequestUri() + "”!", mue1);
 178                 }
 179         }
 180
 181         /**
 182          * Unsubscribes the request URI of the given Sone.
 183          *
 184          * @param sone
 185          *            The Sone to unregister
 186          */
 187         public void unregisterUsk(Sone sone) {
 188                 USKCallback uskCallback = soneUskCallbacks.remove(sone.getId());
 189                 if (uskCallback == null) {
 190                         return;
 191                 }
 192                 try {
 193                         logger.log(Level.FINEST, "Unsubscribing from USK for %s…", new Object[] { sone });
 194                         node.clientCore.uskManager.unsubscribe(USK.create(sone.getRequestUri()), uskCallback);
 195                 } catch (MalformedURLException mue1) {
 196                         logger.log(Level.FINE, "Could not unsubscribe USK “" + sone.getRequestUri() + "”!", mue1);
 197                 }
 198         }
 199
 200 }