M3UFilter (fred API)

java.lang.Object
- freenet.client.filter.M3UFilter

All Implemented Interfaces:

ContentDataFilter
```
public class M3UFilter
extends java.lang.Object
implements ContentDataFilter
```
Content filter for M3Us This one kills every comment and ensures that every file is a safe URL. Currently far too strict: allows only relative paths with as letters alphanumeric or - and exactly one dot. The structure of a simple M3U is just a list of valid relative URLs. The structure of an extended M3U is as follows (taken from http://schworak.com/blog/e39/m3u-play-list-specification/ ): #EXTM3U #EXTINF:233,Title 1 Somewhere\title1.mp3 #EXTINF:129,Title 2 http://www.site.com/~user/title2.mp3 #EXTINF:-1,Stream stream-2016-01-03.m3u #EXTM3U starts the File #EXTINF:, <path> Might be useful to extend to m3u8: https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/StreamingMediaGuide/HTTPStreamingArchitecture/HTTPStreamingArchitecture.html#//apple_ref/doc/uid/TP40008332-CH101-SW10</div> </li> </ul> </div> <div class="summary"> <ul class="blockList"> <li class="blockList">  <ul class="blockList"> <li class="blockList"><a name="constructor.summary">  </a> <h3>Constructor Summary</h3> <table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation"> <caption><span>Constructors</span><span class="tabEnd"> </span></caption> <tr> <th class="colOne" scope="col">Constructor and Description</th> </tr> <tr class="altColor"> <td class="colOne"><code><span class="memberNameLink"><a href="../../../freenet/client/filter/M3UFilter.html#M3UFilter--">M3UFilter</a></span>()</code> </td> </tr> </table> </li> </ul>  <ul class="blockList"> <li class="blockList"><a name="method.summary">  </a> <h3>Method Summary</h3> <table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation"> <caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd"> </span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd"> </span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd"> </span></span></caption> <tr> <th class="colFirst" scope="col">Modifier and Type</th> <th class="colLast" scope="col">Method and Description</th> </tr> <tr id="i0" class="altColor"> <td class="colFirst"><code>void</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../../freenet/client/filter/M3UFilter.html#readFilter-java.io.InputStream-java.io.OutputStream-java.lang.String-java.util.Map-java.lang.String-freenet.client.filter.FilterCallback-">readFilter</a></span>(java.io.InputStream input, java.io.OutputStream output, java.lang.String charset, java.util.Map<java.lang.String,java.lang.String> otherParams, java.lang.String schemeHostAndPort, <a href="../../../freenet/client/filter/FilterCallback.html" title="interface in freenet.client.filter">FilterCallback</a> cb)</code> <div class="block">Filter data for reading.</div> </td> </tr> </table> <ul class="blockList"> <li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">  </a> <h3>Methods inherited from class java.lang.Object</h3> <code>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</code></li> </ul> <ul class="blockList"> <li class="blockList"><a name="methods.inherited.from.class.freenet.client.filter.ContentDataFilter">  </a> <h3>Methods inherited from interface freenet.client.filter.<a href="../../../freenet/client/filter/ContentDataFilter.html" title="interface in freenet.client.filter">ContentDataFilter</a></h3> <code><a href="../../../freenet/client/filter/ContentDataFilter.html#readFilter-java.io.InputStream-java.io.OutputStream-java.lang.String-java.util.Map-freenet.client.filter.FilterCallback-">readFilter</a></code></li> </ul> </li> </ul> </li> </ul> </div> <div class="details"> <ul class="blockList"> <li class="blockList">  <ul class="blockList"> <li class="blockList"><a name="constructor.detail">  </a> <h3>Constructor Detail</h3> <a name="M3UFilter--">  </a> <ul class="blockListLast"> <li class="blockList"> <h4>M3UFilter</h4> <pre>public M3UFilter()</pre> </li> </ul> </li> </ul>  <ul class="blockList"> <li class="blockList"><a name="method.detail">  </a> <h3>Method Detail</h3> <a name="readFilter-java.io.InputStream-java.io.OutputStream-java.lang.String-java.util.Map-java.lang.String-freenet.client.filter.FilterCallback-">  </a> <ul class="blockListLast"> <li class="blockList"> <h4>readFilter</h4> <pre>public void readFilter(java.io.InputStream input, java.io.OutputStream output, java.lang.String charset, java.util.Map<java.lang.String,java.lang.String> otherParams, java.lang.String schemeHostAndPort, <a href="../../../freenet/client/filter/FilterCallback.html" title="interface in freenet.client.filter">FilterCallback</a> cb) throws <a href="../../../freenet/client/filter/DataFilterException.html" title="class in freenet.client.filter">DataFilterException</a>, java.io.IOException</pre> <div class="block"><span class="descfrmTypeLabel">Description copied from interface: <code><a href="../../../freenet/client/filter/ContentDataFilter.html#readFilter-java.io.InputStream-java.io.OutputStream-java.lang.String-java.util.Map-java.lang.String-freenet.client.filter.FilterCallback-">ContentDataFilter</a></code></span></div> <div class="block">Filter data for reading. Objective is to ensure the data is safe if rendered by e.g. a web browser, and to guarantee that it is of the correct type. Filters should usually be implemented as "white list", that is, they should parse everything, and when encountering anything they cannot parse, should delete it, or throw a DataFilterException. IMPORTANT Implementation note: The InputStream may be a PipedInputStream (or conceivably even a network stream). Implementations MUST NOT ASSUME that input.available() == 0 => EOF!</div> <dl> <dt><span class="overrideSpecifyLabel">Specified by:</span></dt> <dd><code><a href="../../../freenet/client/filter/ContentDataFilter.html#readFilter-java.io.InputStream-java.io.OutputStream-java.lang.String-java.util.Map-java.lang.String-freenet.client.filter.FilterCallback-">readFilter</a></code> in interface <code><a href="../../../freenet/client/filter/ContentDataFilter.html" title="interface in freenet.client.filter">ContentDataFilter</a></code></dd> <dt><span class="paramLabel">Parameters:</span></dt> <dd><code>input</code> - Stream to read potentially unsafe data from.</dd> <dd><code>output</code> - Stream to write safe (but possibly incomplete) data to.</dd> <dd><code>charset</code> - Character set of the data if appropriate for this MIME type.</dd> <dd><code>otherParams</code> - Other type parameters if appropriate.</dd> <dd><code>schemeHostAndPort</code> - Scheme, host and port of the node as seen in the request.</dd> <dd><code>cb</code> - Filter callback for modifying HTML tags. Irrelevant for most MIME types. In future we might need this for other types.</dd> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../../freenet/client/filter/DataFilterException.html" title="class in freenet.client.filter">DataFilterException</a></code> - If the data cannot be filtered. Any data written so far should be discarded if possible.</dd> <dd><code>java.io.IOException</code> - If there was a failure to read from the input data or write to the output data. Implementations should not throw this if data is merely badly formatted - any such exceptions should be caught and converted to a DataFilterException.</dd> </dl> </li> </ul> </li> </ul> </li> </ul> </div> </div>   <div class="bottomNav"><a name="navbar.bottom">  </a> <div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div> <a name="navbar.bottom.firstrow">  </a> <ul class="navList" title="Navigation"> <li><a href="../../../overview-summary.html">Overview</a></li> <li><a href="package-summary.html">Package</a></li> <li class="navBarCell1Rev">Class</li> <li><a href="package-tree.html">Tree</a></li> <li><a href="../../../deprecated-list.html">Deprecated</a></li> <li><a href="../../../index-all.html">Index</a></li> <li><a href="../../../help-doc.html">Help</a></li> </ul> </div> <div class="subNav"> <ul class="navList"> <li><a href="../../../freenet/client/filter/LinkFilterExceptionProvider.html" title="interface in freenet.client.filter"><span class="typeNameLink">Prev Class</span></a></li> <li><a href="../../../freenet/client/filter/MP3Filter.html" title="class in freenet.client.filter"><span class="typeNameLink">Next Class</span></a></li> </ul> <ul class="navList"> <li><a href="../../../index.html?freenet/client/filter/M3UFilter.html" target="_top">Frames</a></li> <li><a href="M3UFilter.html" target="_top">No Frames</a></li> </ul> <ul class="navList" id="allclasses_navbar_bottom"> <li><a href="../../../allclasses-noframe.html">All Classes</a></li> </ul> <div> <script type="text/javascript"> </script> </div> <div> <ul class="subNavList"> <li>Summary: </li> <li>Nested | </li> <li>Field | </li> <li><a href="#constructor.summary">Constr</a> | </li> <li><a href="#method.summary">Method</a></li> </ul> <ul class="subNavList"> <li>Detail: </li> <li>Field | </li> <li><a href="#constructor.detail">Constr</a> | </li> <li><a href="#method.detail">Method</a></li> </ul> </div> <a name="skip.navbar.bottom">  </a></div>  </body> </html>

Class M3UFilter