Java tutorial
/* * Copyright 2007 Yusuke Yamamoto * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package twitter4j; import twitter4j.auth.AccessToken; import twitter4j.auth.Authorization; import twitter4j.auth.AuthorizationFactory; import twitter4j.auth.OAuthAuthorization; import twitter4j.conf.Configuration; import twitter4j.conf.ConfigurationContext; /** * A factory class for TwitterFactory.<br> * An instance of this class is completely thread safe and can be re-used and used concurrently.<br> * Note that TwitterStream is NOT compatible with Google App Engine as GAE is not capable of handling requests longer than 30 seconds. * * @author Yusuke Yamamoto - yusuke at mac.com * @since Twitter4J 2.1.0 */ public final class TwitterStreamFactory implements java.io.Serializable { private static final long serialVersionUID = -5181136070759074681L; private final Configuration conf; private static final TwitterStream SINGLETON; static { SINGLETON = new TwitterStreamImpl(ConfigurationContext.getInstance(), TwitterFactory.DEFAULT_AUTHORIZATION); } /** * Creates a TwitterStreamFactory with the root configuration. */ public TwitterStreamFactory() { this(ConfigurationContext.getInstance()); } /** * Creates a TwitterStreamFactory with the given configuration. * * @param conf the configuration to use * @since Twitter4J 2.1.1 */ public TwitterStreamFactory(Configuration conf) { this.conf = conf; } /** * Creates a TwitterStreamFactory with a specified config tree. * * @param configTreePath the path */ public TwitterStreamFactory(String configTreePath) { this(ConfigurationContext.getInstance(configTreePath)); } // implementations for BasicSupportFactory /** * Returns a instance associated with the configuration bound to this factory. * * @return default instance */ public TwitterStream getInstance() { return getInstance(AuthorizationFactory.getInstance(conf)); } /** * Returns a OAuth Authenticated instance.<br> * consumer key and consumer Secret must be provided by twitter4j.properties, or system properties. * Unlike {@link TwitterStream#setOAuthAccessToken(twitter4j.auth.AccessToken)}, this factory method potentially returns a cached instance. * * @param accessToken access token * @return an instance */ public TwitterStream getInstance(AccessToken accessToken) { String consumerKey = conf.getOAuthConsumerKey(); String consumerSecret = conf.getOAuthConsumerSecret(); if (null == consumerKey && null == consumerSecret) { throw new IllegalStateException("Consumer key and Consumer secret not supplied."); } OAuthAuthorization oauth = new OAuthAuthorization(conf); oauth.setOAuthAccessToken(accessToken); return getInstance(conf, oauth); } /** * Returns a instance. * * @param auth authorization object to be associated * @return an instance */ public TwitterStream getInstance(Authorization auth) { return getInstance(conf, auth); } private TwitterStream getInstance(Configuration conf, Authorization auth) { return new TwitterStreamImpl(conf, auth); } /** * Returns default singleton TwitterStream instance. * * @return default singleton TwitterStream instance * @since Twitter4J 2.2.4 */ public static TwitterStream getSingleton() { return SINGLETON; } }