📄 timeseries.html
字号:
<FONT color="green">140</FONT> }<a name="line.140"></a><FONT color="green">141</FONT> <a name="line.141"></a><FONT color="green">142</FONT> /**<a name="line.142"></a><FONT color="green">143</FONT> * Creates a new time series that contains no data.<a name="line.143"></a><FONT color="green">144</FONT> * <P><a name="line.144"></a><FONT color="green">145</FONT> * Descriptions can be specified for the domain and range. One situation<a name="line.145"></a><FONT color="green">146</FONT> * where this is helpful is when generating a chart for the time series -<a name="line.146"></a><FONT color="green">147</FONT> * axis labels can be taken from the domain and range description.<a name="line.147"></a><FONT color="green">148</FONT> *<a name="line.148"></a><FONT color="green">149</FONT> * @param name the name of the series (<code>null</code> not permitted).<a name="line.149"></a><FONT color="green">150</FONT> * @param domain the domain description (<code>null</code> permitted).<a name="line.150"></a><FONT color="green">151</FONT> * @param range the range description (<code>null</code> permitted).<a name="line.151"></a><FONT color="green">152</FONT> * @param timePeriodClass the type of time period (<code>null</code> not <a name="line.152"></a><FONT color="green">153</FONT> * permitted).<a name="line.153"></a><FONT color="green">154</FONT> */<a name="line.154"></a><FONT color="green">155</FONT> public TimeSeries(String name, String domain, String range, <a name="line.155"></a><FONT color="green">156</FONT> Class timePeriodClass) {<a name="line.156"></a><FONT color="green">157</FONT> super(name);<a name="line.157"></a><FONT color="green">158</FONT> this.domain = domain;<a name="line.158"></a><FONT color="green">159</FONT> this.range = range;<a name="line.159"></a><FONT color="green">160</FONT> this.timePeriodClass = timePeriodClass;<a name="line.160"></a><FONT color="green">161</FONT> this.data = new java.util.ArrayList();<a name="line.161"></a><FONT color="green">162</FONT> this.maximumItemCount = Integer.MAX_VALUE;<a name="line.162"></a><FONT color="green">163</FONT> this.maximumItemAge = Long.MAX_VALUE;<a name="line.163"></a><FONT color="green">164</FONT> }<a name="line.164"></a><FONT color="green">165</FONT> <a name="line.165"></a><FONT color="green">166</FONT> /**<a name="line.166"></a><FONT color="green">167</FONT> * Returns the domain description.<a name="line.167"></a><FONT color="green">168</FONT> *<a name="line.168"></a><FONT color="green">169</FONT> * @return The domain description (possibly <code>null</code>).<a name="line.169"></a><FONT color="green">170</FONT> * <a name="line.170"></a><FONT color="green">171</FONT> * @see #setDomainDescription(String)<a name="line.171"></a><FONT color="green">172</FONT> */<a name="line.172"></a><FONT color="green">173</FONT> public String getDomainDescription() {<a name="line.173"></a><FONT color="green">174</FONT> return this.domain;<a name="line.174"></a><FONT color="green">175</FONT> }<a name="line.175"></a><FONT color="green">176</FONT> <a name="line.176"></a><FONT color="green">177</FONT> /**<a name="line.177"></a><FONT color="green">178</FONT> * Sets the domain description and sends a <code>PropertyChangeEvent</code> <a name="line.178"></a><FONT color="green">179</FONT> * (with the property name <code>Domain</code>) to all registered<a name="line.179"></a><FONT color="green">180</FONT> * property change listeners.<a name="line.180"></a><FONT color="green">181</FONT> *<a name="line.181"></a><FONT color="green">182</FONT> * @param description the description (<code>null</code> permitted).<a name="line.182"></a><FONT color="green">183</FONT> * <a name="line.183"></a><FONT color="green">184</FONT> * @see #getDomainDescription()<a name="line.184"></a><FONT color="green">185</FONT> */<a name="line.185"></a><FONT color="green">186</FONT> public void setDomainDescription(String description) {<a name="line.186"></a><FONT color="green">187</FONT> String old = this.domain;<a name="line.187"></a><FONT color="green">188</FONT> this.domain = description;<a name="line.188"></a><FONT color="green">189</FONT> firePropertyChange("Domain", old, description);<a name="line.189"></a><FONT color="green">190</FONT> }<a name="line.190"></a><FONT color="green">191</FONT> <a name="line.191"></a><FONT color="green">192</FONT> /**<a name="line.192"></a><FONT color="green">193</FONT> * Returns the range description.<a name="line.193"></a><FONT color="green">194</FONT> *<a name="line.194"></a><FONT color="green">195</FONT> * @return The range description (possibly <code>null</code>).<a name="line.195"></a><FONT color="green">196</FONT> * <a name="line.196"></a><FONT color="green">197</FONT> * @see #setRangeDescription(String)<a name="line.197"></a><FONT color="green">198</FONT> */<a name="line.198"></a><FONT color="green">199</FONT> public String getRangeDescription() {<a name="line.199"></a><FONT color="green">200</FONT> return this.range;<a name="line.200"></a><FONT color="green">201</FONT> }<a name="line.201"></a><FONT color="green">202</FONT> <a name="line.202"></a><FONT color="green">203</FONT> /**<a name="line.203"></a><FONT color="green">204</FONT> * Sets the range description and sends a <code>PropertyChangeEvent</code> <a name="line.204"></a><FONT color="green">205</FONT> * (with the property name <code>Range</code>) to all registered listeners.<a name="line.205"></a><FONT color="green">206</FONT> *<a name="line.206"></a><FONT color="green">207</FONT> * @param description the description (<code>null</code> permitted).<a name="line.207"></a><FONT color="green">208</FONT> * <a name="line.208"></a><FONT color="green">209</FONT> * @see #getRangeDescription()<a name="line.209"></a><FONT color="green">210</FONT> */<a name="line.210"></a><FONT color="green">211</FONT> public void setRangeDescription(String description) {<a name="line.211"></a><FONT color="green">212</FONT> String old = this.range;<a name="line.212"></a><FONT color="green">213</FONT> this.range = description;<a name="line.213"></a><FONT color="green">214</FONT> firePropertyChange("Range", old, description);<a name="line.214"></a><FONT color="green">215</FONT> }<a name="line.215"></a><FONT color="green">216</FONT> <a name="line.216"></a><FONT color="green">217</FONT> /**<a name="line.217"></a><FONT color="green">218</FONT> * Returns the number of items in the series.<a name="line.218"></a><FONT color="green">219</FONT> *<a name="line.219"></a><FONT color="green">220</FONT> * @return The item count.<a name="line.220"></a><FONT color="green">221</FONT> */<a name="line.221"></a><FONT color="green">222</FONT> public int getItemCount() {<a name="line.222"></a><FONT color="green">223</FONT> return this.data.size();<a name="line.223"></a><FONT color="green">224</FONT> }<a name="line.224"></a><FONT color="green">225</FONT> <a name="line.225"></a><FONT color="green">226</FONT> /**<a name="line.226"></a><FONT color="green">227</FONT> * Returns the list of data items for the series (the list contains <a name="line.227"></a><FONT color="green">228</FONT> * {@link TimeSeriesDataItem} objects and is unmodifiable).<a name="line.228"></a><FONT color="green">229</FONT> *<a name="line.229"></a><FONT color="green">230</FONT> * @return The list of data items.<a name="line.230"></a><FONT color="green">231</FONT> */<a name="line.231"></a><FONT color="green">232</FONT> public List getItems() {<a name="line.232"></a><FONT color="green">233</FONT> return Collections.unmodifiableList(this.data);<a name="line.233"></a><FONT color="green">234</FONT> }<a name="line.234"></a><FONT color="green">235</FONT> <a name="line.235"></a><FONT color="green">236</FONT> /**<a name="line.236"></a><FONT color="green">237</FONT> * Returns the maximum number of items that will be retained in the series.<a name="line.237"></a><FONT color="green">238</FONT> * The default value is <code>Integer.MAX_VALUE</code>.<a name="line.238"></a><FONT color="green">239</FONT> *<a name="line.239"></a><FONT color="green">240</FONT> * @return The maximum item count.<a name="line.240"></a><FONT color="green">241</FONT> * <a name="line.241"></a><FONT color="green">242</FONT> * @see #setMaximumItemCount(int)<a name="line.242"></a><FONT color="green">243</FONT> */<a name="line.243"></a><FONT color="green">244</FONT> public int getMaximumItemCount() {<a name="line.244"></a><FONT color="green">245</FONT> return this.maximumItemCount;<a name="line.245"></a><FONT color="green">246</FONT> }<a name="line.246"></a><FONT color="green">247</FONT> <a name="line.247"></a><FONT color="green">248</FONT> /**<a name="line.248"></a><FONT color="green">249</FONT> * Sets the maximum number of items that will be retained in the series. <a name="line.249"></a><FONT color="green">250</FONT> * If you add a new item to the series such that the number of items will <a name="line.250"></a><FONT color="green">251</FONT> * exceed the maximum item count, then the FIRST element in the series is <a name="line.251"></a><FONT color="green">252</FONT> * automatically removed, ensuring that the maximum item count is not <a name="line.252"></a><FONT color="green">253</FONT> * exceeded.<a name="line.253"></a><FONT color="green">254</FONT> *<a name="line.254"></a><FONT color="green">255</FONT> * @param maximum the maximum (requires >= 0).<a name="line.255"></a><FONT color="green">256</FONT> * <a name="line.256"></a><FONT color="green">257</FONT> * @see #getMaximumItemCount()<a name="line.257"></a><FONT color="green">258</FONT> */<a name="line.258"></a><FONT color="green">259</FONT> public void setMaximumItemCount(int maximum) {<a name="line.259"></a><FONT color="green">260</FONT> if (maximum < 0) {<a name="line.260"></a><FONT color="green">261</FONT> throw new IllegalArgumentException("Negative 'maximum' argument.");<a name="line.261"></a><FONT color="green">262</FONT> }<a name="line.262"></a><FONT color="green">263</FONT> this.maximumItemCount = maximum;<a name="line.263"></a><FONT color="green">264</FONT> int count = this.data.size();<a name="line.264"></a><FONT color="green">265</FONT> if (count > maximum) {<a name="line.265"></a><FONT color="green">266</FONT> delete(0, count - maximum - 1);<a name="line.266"></a><FONT color="green">267</FONT> }<a name="line.267"></a><FONT color="green">268</FONT> }<a name="line.268"></a><FONT color="green">269</FONT> <a name="line.269"></a><FONT color="green">270</FONT> /**<a name="line.270"></a><FONT color="green">271</FONT> * Returns the maximum item age (in time periods) for the series.<a name="line.271"></a><FONT color="green">272</FONT> *<a name="line.272"></a><FONT color="green">273</FONT> * @return The maximum item age.<a name="line.273"></a><FONT color="green">274</FONT> * <a name="line.274"></a><FONT color="green">275</FONT> * @see #setMaximumItemAge(long)<a name="line.275"></a><FONT color="green">276</FONT> */<a name="line.276"></a><FONT color="green">277</FONT> public long getMaximumItemAge() {<a name="line.277"></a><FONT color="green">278</FONT> return this.maximumItemAge;<a name="line.278"></a><FONT color="green">279</FONT> }<a name="line.279"></a><FONT color="green">280</FONT> <a name="line.280"></a><FONT color="green">281</FONT> /**<a name="line.281"></a>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -