proft.me - Блог о Linux, Python, Vim и другом здоровом образе жизни

Просмотр своих и чужих фотографий в Instagram под Android

Wed, 06 Sep 2017 00:00:00 +0300

Так как у Instagram нету родного API под Android платформу для авторизации и просмотра чужих и своих фотографий, то в этой статье мы реализуем 5 классов, с помощью которых сможем авторизовать пользователя и отобразить список его фоток в GridView.

Для начала нам нужен обычный аккаунт в Instagram из которого мы сделаем аккаунт для разработчиков тут. Дальше нам нужно выбрать Register new Client ID и заполнить все поля. После этого у нас будет Application в Sandbox режиме. Это означает, что мы можем пригласить еще 9 человек (смотри вкладку Sandbox в Manage Client) и тестировать возможности Instagram REST API между ними. После этого можно можно пройти рецензию и получить нужные права для того что-бы все другие пользователи могли использовать Instagram REST API а не только 9 человек из Sandbox.

Для общения с Instagram REST API будет использоваться OKHttp, а для загрузки фоток будет использоваться Glide.

Дальше создаем пакет instagram в корне нашего проекта и начинаем наполнять его вспомогательными классами. Первым из них будет класс Instagram, его основная функция - инициализация Instagram клиента.

// file instagram/Instagram.java
public class Instagram {
    public static final String AUTH_URL = "https://instagram.com/oauth/authorize/?";
    public static final String ACCESS_TOKEN_URL = "https://api.instagram.com/oauth/access_token";
    public static final String API_BASE_URL = "https://api.instagram.com/v1";

    private Context context;

    private InstagramDialog dlg;
    private InstagramAuthListener listener;
    private InstagramSession session;

    private String clientId;
    private String clientSecret;
    private String redirectUri;

    public Instagram(Context context, String clientId, String clientSecret, String redirectUri) {
        this.context = context;
        this.clientId = clientId;
        this.clientSecret = clientSecret;
        this.redirectUri = redirectUri;

        String authUrl = AUTH_URL + "client_id=" + clientId + "&redirect_uri=" + redirectUri + "&response_type=code&scope=basic+public_content";

        session = new InstagramSession(context);
        dlg = new InstagramDialog(context, authUrl, redirectUri, new InstagramDialog.InstagramDialogListener() {
            @Override
            public void onSuccess(String code) {
                retrieveAccessToken(code);
            }

            @Override
            public void onError(String error) {
                listener.onError(error);
            }

            @Override
            public void onCancel() {
                listener.onCancel();
            }
        });
    }

    public void authorize(InstagramAuthListener listener) {
        this.listener = listener;
        dlg.show();
    }

    public void resetSession() {
        session.reset();
        dlg.clearCache();
    }

    public InstagramSession getSession() {
        return session;
    }

    private void retrieveAccessToken(String code) {
        new AccessTokenTask(code).execute();
    }

    public class AccessTokenTask extends AsyncTask<URL, Integer, Long> {        
        ProgressDialog progressDlg;
        InstagramUser user;
        String code;

        public AccessTokenTask(String code) {
            this.code = code;
            progressDlg = new ProgressDialog(context);
            progressDlg.setMessage("Getting access token...");          
        }

        protected void onCancelled() {
            progressDlg.cancel();
        }

        protected void onPreExecute() {
            progressDlg.show();
        }

        protected Long doInBackground(URL... urls) {         
            long result = 0;

            try {
                HashMap<String, String> params = new HashMap<String, String>(5);

                params.put("client_id", clientId);
                params.put("client_secret", clientSecret);
                params.put("grant_type", "authorization_code");
                params.put("redirect_uri", redirectUri);
                params.put("code", code);

                InstagramRequest request = new InstagramRequest();
                String response = request.post(ACCESS_TOKEN_URL, params);

                if (!response.equals("")) {
                    JSONObject jsonObj = (JSONObject) new JSONTokener(response).nextValue();
                    JSONObject jsonUser = jsonObj.getJSONObject("user");

                    user = new InstagramUser();
                    user.accessToken = jsonObj.getString("access_token");
                    user.id = jsonUser.getString("id");
                    user.username = jsonUser.getString("username");
                    user.fullName = jsonUser.getString("full_name");
                    user.profilePicture = jsonUser.getString("profile_picture");
                }                       
            } catch (Exception e) { 
                e.printStackTrace();
            }

            return result;
        }

        protected void onProgressUpdate(Integer... progress) {}

        protected void onPostExecute(Long result) {         
            progressDlg.dismiss();

            if (user != null) {
                session.store(user);
                listener.onSuccess(user);
            } else {
                listener.onError("Failed to get access token");
            }
        }                
    }

    public interface InstagramAuthListener {
        public abstract void onSuccess(InstagramUser user);
        public abstract void onError(String error);
        public abstract void onCancel();
    }

    public ArrayList<String> getUserMedia(String token, int count, String userID) {
        ArrayList<String> photoList = new ArrayList<String>();

        try {
            HashMap<String, String> params = new HashMap<String, String>(1);
            params.put("count", String.valueOf(count));

            InstagramRequest request = new InstagramRequest(token);
            String response = request.createRequest("GET", "/users/" + userID + "/media/recent", params);

            if (!response.equals("")) {
                JSONObject jsonObj = (JSONObject) new JSONTokener(response).nextValue();
                JSONArray jsonData= jsonObj.getJSONArray("data");

                int length = jsonData.length();

                if (length > 0) {
                    photoList = new ArrayList<String>();

                    for (int i = 0; i < length; i++) {
                        JSONObject jsonPhoto = jsonData.getJSONObject(i).getJSONObject("images").getJSONObject("low_resolution");
                        photoList.add(jsonPhoto.getString("url"));
                    }
                }
            }
        } catch (Exception e) {
            e.printStackTrace();
        }

        return photoList;
    }
}

Следующий по списку класс для инициализации WebView с помощью которого будет происходить авторизация пользователя в Instagram.

// file instagram/InstagramDialog.java
@SuppressLint({ "NewApi", "SetJavaScriptEnabled" })
public class InstagramDialog extends Dialog {

    private ProgressDialog spinner;
    private WebView webView;
    private LinearLayout content;
    private TextView tvTitle;

    private String authUrl;
    private String redirectUri;

    private InstagramDialogListener listener;

    static final FrameLayout.LayoutParams FILL = new FrameLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT,
            ViewGroup.LayoutParams.WRAP_CONTENT);

    static final int MARGIN = 8;
    static final int PADDING = 2;

    static final String TAG = "DBG";

    public InstagramDialog(Context context, String authUrl, String redirectUri, InstagramDialogListener listener) {
        super(context);
        this.authUrl = authUrl;
        this.listener = listener;
        this.redirectUri = redirectUri;
    }

    @SuppressWarnings("deprecation")
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        spinner = new ProgressDialog(getContext());
        spinner.requestWindowFeature(Window.FEATURE_NO_TITLE);
        spinner.setMessage("Loading...");

        content = new LinearLayout(getContext());
        content.setOrientation(LinearLayout.VERTICAL);

        setUpTitle();
        setUpWebView();

        Display display = getWindow().getWindowManager().getDefaultDisplay();
        Point outSize = new Point();

        int width = 0;
        int height = 0;

        double[] dimensions = new double[2];

        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB_MR2) {
            display.getSize(outSize);

            width = outSize.x;
            height = outSize.y;
        } else {
            width = display.getWidth();
            height = display.getHeight();
        }

        if (width < height) {
            dimensions[0] = 0.87 * width;
            dimensions[1] = 0.82 * height;
        } else {
            dimensions[0] = 0.75 * width;
            dimensions[1] = 0.75 * height;
        }

        addContentView(content, new FrameLayout.LayoutParams((int) dimensions[0], (int) dimensions[1]));
    }

    private void setUpTitle() {
        requestWindowFeature(Window.FEATURE_NO_TITLE);

        //Drawable icon = getContext().getResources().getDrawable(R.drawable.icon);

        tvTitle = new TextView(getContext());

        tvTitle.setText("Instagram");
        tvTitle.setTextColor(Color.WHITE);
        tvTitle.setTypeface(Typeface.DEFAULT_BOLD);
        tvTitle.setBackgroundColor(0xFF163753);
        tvTitle.setPadding(MARGIN + PADDING, MARGIN, MARGIN, MARGIN);
        tvTitle.setCompoundDrawablePadding(MARGIN + PADDING);
        //title.setCompoundDrawablesWithIntrinsicBounds(icon, null, null, null);

        content.addView(tvTitle);
    }

    private void setUpWebView() {
        webView = new WebView(getContext());

        webView.setVerticalScrollBarEnabled(false);
        webView.setHorizontalScrollBarEnabled(false);
        webView.setWebViewClient(new InstagramWebViewClient());
        webView.getSettings().setJavaScriptEnabled(true);
        webView.loadUrl(authUrl);
        webView.setLayoutParams(FILL);
        //webView.setLayoutParams(FILL);

        WebSettings webSettings = webView.getSettings();

        webSettings.setSavePassword(true);
        webSettings.setSaveFormData(false);

        content.addView(webView);
    }

    public void clearCache() {
        webView.clearCache(true);
        webView.clearHistory();
        webView.clearFormData();
    }

    @Override
    public void onBackPressed() {
        super.onBackPressed();
        clearCache();
        listener.onCancel();
    }

    private class InstagramWebViewClient extends WebViewClient {

        @Override
        public boolean shouldOverrideUrlLoading(WebView view, String url) {
            Log.d(TAG, "Redirecting URL " + url);

            if (url.startsWith(redirectUri)) {
                if (url.contains("code")) {
                    String temp[] = url.split("=");
                    listener.onSuccess(temp[1]);
                } else if (url.contains("error")) {
                    String temp[] = url.split("=");
                    listener.onError(temp[temp.length-1]);
                }

                InstagramDialog.this.dismiss();
                return true;
            }

            return false;
        }

        @Override
        public void onReceivedError(WebView view, int errorCode, String description, String failingUrl) {   
            super.onReceivedError(view, errorCode, description, failingUrl);
            listener.onError(description);
            InstagramDialog.this.dismiss();
            Log.d(TAG, "Page error: " + description);
        }

        @Override
        public void onPageStarted(WebView view, String url, Bitmap favicon) {
            super.onPageStarted(view, url, favicon);
            spinner.show();
            Log.d(TAG, "Loading URL: " + url);
        }

        @Override
        public void onPageFinished(WebView view, String url) {
            super.onPageFinished(view, url);

            String title = webView.getTitle();
            if (title != null && title.length() > 0) {
                tvTitle.setText(title);
            }
            spinner.dismiss();
        }
    }

    public interface InstagramDialogListener {
        public abstract void onSuccess(String code);
        public abstract void onCancel();
        public abstract void onError(String error);
    }
}

Класс InstagramRequest используется для выполнения GET и POST запросов к Instagram REST API. Этот класс использует OkHttp для общения с Instagram REST API. Как настроить и использовать OkHttp читай в How to do GET and POST requests in Android using OkHttp .

Для сохранения токена после авторизации и других данных о пользователе создадим класс InstagramSession.

// file instagram/InstagramSession.java
public class InstagramSession {
    private Context context;
    private SharedPreferences sp;

    private static final String SHARED = "Instagram_Preferences";
    private static final String USERID  = "userid";
    private static final String USERNAME = "username";
    private static final String FULLNAME = "fullname";
    private static final String PROFILEPIC = "profilepic";
    private static final String ACCESS_TOKEN = "access_token";

    public InstagramSession(Context context) {
        this.context = context;
        this.sp = context.getSharedPreferences(SHARED, Context.MODE_PRIVATE);
    }

    public void store(InstagramUser user) {
        Editor editor = sp.edit();

        editor.putString(ACCESS_TOKEN, user.accessToken);
        editor.putString(USERID, user.id);
        editor.putString(USERNAME, user.username);
        editor.putString(FULLNAME, user.fullName);
        editor.putString(PROFILEPIC, user.profilePicture);

        editor.commit();
    }

    public void reset() {
        Editor editor = sp.edit();

        editor.putString(ACCESS_TOKEN, "");
        editor.putString(USERID, "");
        editor.putString(USERNAME, "");
        editor.putString(FULLNAME, "");
        editor.putString(PROFILEPIC, "");

        editor.commit();

        CookieSyncManager.createInstance(context);

        CookieManager cookieManager = CookieManager.getInstance();
        cookieManager.removeAllCookie();
    }

    public InstagramUser getUser() {
        if (sp.getString(ACCESS_TOKEN, "").equals("")) {
            return null;
        }

        InstagramUser user = new InstagramUser();

        user.id = sp.getString(USERID, "");
        user.username = sp.getString(USERNAME, "");
        user.fullName = sp.getString(FULLNAME, "");
        user.profilePicture = sp.getString(PROFILEPIC, "");
        user.accessToken = sp.getString(ACCESS_TOKEN, "");

        return user;
    }

    public String getAccessToken() {
        return sp.getString(ACCESS_TOKEN, "");
    }

    public boolean isActive() {
        return (sp.getString(ACCESS_TOKEN, "").equals("")) ? false : true;
    }
}

Класс InstagramUser будет хранить в себе информацию о авторизированном пользователе.

public class InstagramUser {
    public String id;
    public String username;
    public String fullName;
    public String profilePicture;
    public String accessToken;

    @Override
    public String toString() {
        return "InstagramUser{" +
                "id='" + id + '\'' +
                ", username='" + username + '\'' +
                ", fullName='" + fullName + '\'' +
                ", profilPicture='" + profilePicture + '\'' +
                '}';
    }
}

Создадим Activity, в которой соберем все вспомогательные классы в рабочую цепочку.

public class InstagramActivity extends AppCompatActivity {
    private InstagramSession instagramSession;
    private Instagram instagram;

    private ProgressBar pbLading;
    private GridView gvPhotos;
    private LinearLayout llInstagramOff;
    private RelativeLayout rlInstagramOn;
    private Button btnLogout, btnLogin;

    private static final String CLIENT_ID = "XXX";
    private static final String CLIENT_SECRET = "XXX";
    private static final String REDIRECT_URI = "XXX";
    String TAG = "VVV";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_instagram);

        llInstagramOff =  (LinearLayout) findViewById(R.id.llInstagramOff);
        rlInstagramOn =  (RelativeLayout) findViewById(R.id.rlInstagramOn);
        btnLogin =  (Button) findViewById(R.id.btnLogin);
        btnLogout =  (Button) findViewById(R.id.btnLogout);

        btnLogout.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View arg0) {
                instagramSession.reset();
                toggleInstagram();
            }
        });

        btnLogin.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View arg0) {
                instagram.authorize(mAuthListener);
            }
        });

        instagram = new Instagram(this, CLIENT_ID, CLIENT_SECRET, REDIRECT_URI);
        instagramSession = instagram.getSession();
        //toggleInstagram();

        loadInstagram();
    }


    private Instagram.InstagramAuthListener mAuthListener = new Instagram.InstagramAuthListener() {
        @Override
        public void onSuccess(InstagramUser user) {
            loadInstagram();
        }

        @Override
        public void onError(String error) {
            Toast.makeText(InstagramActivity.this, error, Toast.LENGTH_SHORT).show();
        }

        @Override
        public void onCancel() {
            Toast.makeText(InstagramActivity.this, "OK. Maybe later?", Toast.LENGTH_SHORT).show();
        }
    };


    private void loadInstagram() {
        if (instagramSession.isActive()) {
            InstagramUser instagramUser = instagramSession.getUser();
            Log.d(TAG, "loadInstagram: " + instagramUser);

            pbLading = (ProgressBar) findViewById(R.id.pbLading);
            gvPhotos = (GridView) findViewById(R.id.gvPhotos);

            ((TextView) findViewById(R.id.tv_name)).setText(instagramUser.fullName);
            ((TextView) findViewById(R.id.tv_username)).setText(instagramUser.username);

            ImageView userIv = (ImageView) findViewById(R.id.iv_user);
            Glide.with(this).load(instagramUser.profilePicture).into(userIv);
            //Log.d(TAG, "instagramUser.profilPicture: " + instagramUser.profilPicture);

            new DownloadTask().execute();
        }
        toggleInstagram();
    }


    private void toggleInstagram() {
        if (instagramSession.isActive()) {
            llInstagramOff.setVisibility(View.GONE);
            rlInstagramOn.setVisibility(View.VISIBLE);
        } else {
            llInstagramOff.setVisibility(View.VISIBLE);
            rlInstagramOn.setVisibility(View.GONE);
        }
    }


    public class DownloadTask extends AsyncTask<URL, Integer, Long> {
        ArrayList<String> photoList;

        protected void onCancelled() {}

        protected void onPreExecute() {}

        protected Long doInBackground(URL... urls) {
            long result = 0;
            //String userId = instagramSession.getUser().id;
            String userId = "6000222747";
            photoList = instagram.getUserMedia(instagramSession.getAccessToken(), 10, userId);
            return result;
        }

        protected void onProgressUpdate(Integer... progress) {
        }

        protected void onPostExecute(Long result) {
            pbLading.setVisibility(View.GONE);

            if (photoList == null) {
                Toast.makeText(getApplicationContext(), "No photos available", Toast.LENGTH_LONG).show();
            } else {
                Log.d(TAG, "onPostExecute: " + photoList);

                DisplayMetrics dm = new DisplayMetrics();
                getWindowManager().getDefaultDisplay().getMetrics(dm);

                int width   = (int) Math.ceil((double) dm.widthPixels / 3);
                width = width - 20;
                int height  = width;

                PhotoListAdapter adapter = new PhotoListAdapter(InstagramActivity.this);
                adapter.setData(photoList);
                adapter.setLayoutParam(width, height);
                gvPhotos.setAdapter(adapter);
            }
        }
    }

}

Layout для этой активити такой.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <!-- OFF -->

    <LinearLayout
        android:id="@+id/llInstagramOff"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:visibility="visible"
        android:gravity="center">

        <Button
            android:id="@+id/btnLogin"
            android:layout_width="175dp"
            android:layout_height="wrap_content"
            android:text="Log in" />
    </LinearLayout>

    <!-- ON -->

    <RelativeLayout
        android:id="@+id/rlInstagramOn"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:visibility="gone"
        android:padding="5dp">

        <ImageView
            android:id="@+id/iv_user"
            android:layout_width="100dp"
            android:layout_height="100dp"
            android:contentDescription="@string/app_name"
            android:src="@drawable/c19" />

        <LinearLayout
            android:layout_toRightOf="@+id/iv_user"
            android:layout_alignTop="@+id/iv_user"
            android:layout_alignBottom="@+id/iv_user"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:layout_marginLeft="10dp"
            android:orientation="vertical"
            android:gravity="center_vertical">

            <TextView
                android:id="@+id/tv_name"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:textColor="#000000"
                android:textStyle="bold"
                android:textSize="17sp"
                android:text="Lorensius Londa"/>

            <TextView
                android:id="@+id/tv_username"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:layout_marginTop="10dp"
                android:text="lorensiuswlt"/>

        </LinearLayout>

        <Button
            android:id="@+id/btnLogout"
            android:layout_below="@+id/iv_user"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:layout_marginTop="10dp"
            android:text="Log out" />

        <RelativeLayout
            android:layout_below="@+id/btnLogout"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:layout_marginTop="10dp" >

            <GridView
                android:id="@+id/gvPhotos"
                android:verticalSpacing="5dp"
                android:horizontalSpacing="5dp"
                android:padding="5dp"
                android:stretchMode="columnWidth"
                android:numColumns="3"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"/>

            <ProgressBar
                style="?android:attr/progressBarStyleLarge"
                android:id="@+id/pbLading"
                android:layout_width="100dp"
                android:layout_height="100dp"
                android:layout_centerInParent="true"/>

        </RelativeLayout>

    </RelativeLayout>

</LinearLayout>

Вспомогательный класс PhotoListAdapter для адаптера для GridView.

public class PhotoListAdapter extends BaseAdapter {
    private Context context;
    private ArrayList<String> photos;
    private int width;
    private int height;

    public PhotoListAdapter(Context context) {
        this.context = context;
    }

    public void setData(ArrayList<String> data) {
        photos = data;
    }

    public void setLayoutParam(int width, int height) {
        this.width  = width;
        this.height = height;
    }

    @Override
    public int getCount() {
        return (photos == null) ? 0 : photos.size();
    }

    @Override
    public Object getItem(int position) {
        return null;
    }

    @Override
    public long getItemId(int position) {
        return 0;
    }

    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        ImageView imageIv;

        if (convertView == null) {
            imageIv = new ImageView(context);

            imageIv.setLayoutParams(new GridView.LayoutParams(width, height));
            imageIv.setScaleType(ImageView.ScaleType.CENTER_INSIDE);
            imageIv.setPadding(0, 0, 0, 0);
        } else {
            imageIv = (ImageView) convertView;
        }

        Glide.with(context).load(photos.get(position)).into(imageIv);

        return imageIv;
    }
}

Результат

Информацию о пользователе в виде json можно получить добавив к url ?__a=1, например, https://www.instagram.com/proftua/?__a=1.

Получение прогноза погоды в Android с помощью Retrofit

Fri, 05 May 2017 00:00:00 +0300

В этой статье вы узнаете как получить погоду с openweathermap.org по координатам пользователя для текущего дня и прогноз на ближайщие 5 дней с помощью библиотеки Retrofit.

Retrofit это REST клиент для Android написанный в Square. Эта библиотека позволяет легко получить и загрузить JSON (или любую другую структуру данных) через REST. Retrofit позволяет настроить какой конвертор использовать для сериализации/десериализации данных. Например, для JSON можно использовать GSON, также можно определить произвольный конвертор для парсинга других структур данных (например, для XML). Retrofit использует OkHttp библиотеку для HTTP запросов.

Побробней познакомится с возможностями Retrofit можно в статье How to get remote resource with Retrofit in Android.

В качестве источника погоды для

одного дня будет использоватся Current weather data API
для прогноза на 5 дней 5 day / 3 hour forecast

Перед использованием OpenWeatherMap API необходимо зарегистрироваться и получить ключ.

В файл AndroidManifest.xml добавим права на Internet и гео-локацию

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

В файл build.gradle (Module:app) добавим Retrofit, Glide и GSON-конвертор

dependencies {
    ...
    compile 'com.google.code.gson:gson:2.8.0'
    compile 'com.squareup.retrofit2:retrofit:2.2.0'
    compile 'com.squareup.retrofit2:converter-gson:2.2.0'
    compile 'com.github.bumptech.glide:glide:3.7.0'
}

Опишем модель данных для прогноза погоды на текущий день как того желает Retrofit.

// файл WeatherDay.java

public class WeatherDay {
    public class WeatherTemp {
        Double temp;
        Double temp_min;
        Double temp_max;
    }

    public class WeatherDescription {
        String icon;
    }

    @SerializedName("main")
    private WeatherTemp temp;

    @SerializedName("weather")
    private List<WeatherDescription> desctiption;

    @SerializedName("name")
    private String city;

    @SerializedName("dt")
    private long timestamp;

    public WeatherDay(WeatherTemp temp, List<WeatherDescription> desctiption) {
        this.temp = temp;
        this.desctiption = desctiption;
    }

    public Calendar getDate() {
        Calendar date = Calendar.getInstance();
        date.setTimeInMillis(timestamp * 1000);
        return date;
    }

    public String getTemp() { return String.valueOf(temp.temp); }

    public String getTempMin() { return String.valueOf(temp.temp_min); }

    public String getTempMax() { return String.valueOf(temp.temp_max); }

    public String getTempInteger() { return String.valueOf(temp.temp.intValue()); }

    public String getTempWithDegree() { return String.valueOf(temp.temp.intValue()) + "\u00B0"; }

    public String getCity() { return city; }

    public String getIcon() { return desctiption.get(0).icon; }

    public String getIconUrl() {
        return "http://openweathermap.org/img/w/" + desctiption.get(0).icon + ".png";
    }
}

Опишем модель данных для прогноза погоды на 5 дней, тут проще, так-как это список из объектов WeatherDay.

// файл WeatherForecast.java

public class WeatherForecast {
    @SerializedName("list")
    private List<WeatherDay> items;

    public WeatherForecast(List<WeatherDay> items) {
        this.items = items;
    }

    public List<WeatherDay> getItems() {
        return items;
    }
}

Опишем сам API, т.е. укажем ключ, входные URL для каждого из прогнозов и параметры которые передаются для получения погоды.

public class WeatherAPI {
    public static String KEY = "KEY";
    public static final String BASE_URL = "http://api.openweathermap.org/data/2.5/";
    private static Retrofit retrofit = null;

    public interface ApiInterface {
        @GET("weather")
        Call<WeatherDay> getToday(
            @Query("lat") Double lat,
            @Query("lon") Double lon,
            @Query("units") String units,
            @Query("appid") String appid
        );

        @GET("forecast")
        Call<WeatherForecast> getForecast(
                @Query("lat") Double lat,
                @Query("lon") Double lon,
                @Query("units") String units,
                @Query("appid") String appid
        );
    }

    public static Retrofit getClient() {
        if (retrofit == null) {
            retrofit = new Retrofit.Builder()
                    .baseUrl(BASE_URL)
                    .addConverterFactory(GsonConverterFactory.create())
                    .build();
        }
        return retrofit;
    }
}

Макет activity_main.xml для Activity простой. В первом LinearLayout (с id = llToday) будет отображаться погода для текущего дня, а во втором LinearLayout (с id = llForecast) будет отображаться прогноз погоды на ближайшие 5 дней (наполнятся програмно), оставляем его пустым.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <LinearLayout
        android:id="@+id/llToday"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal"
        android:layout_marginTop="30dip">

        <TextView
            android:id="@+id/tvTemp"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:textSize="50dp"
            android:text="Weather... " />

        <ImageView
            android:id="@+id/ivImage"
            android:layout_width="wrap_content"
            android:layout_height="60dp" />
        </LinearLayout>


    <LinearLayout
        android:id="@+id/llForecast"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:orientation="horizontal"
        android:layout_marginTop="30dip">
        </LinearLayout>

    <Button
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Get"
        android:onClick="getWeather"/>
</LinearLayout>

Непосредственно сама Activity ниже. Изображения для погоды подгружается с помощью Glide.

public class MainActivity extends AppCompatActivity {
    String TAG = "WEATHER";
    TextView tvTemp;
    ImageView tvImage;
    LinearLayout llForecast;
    WeatherAPI.ApiInterface api;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        tvTemp = (TextView) findViewById(R.id.tvTemp);
        tvImage = (ImageView) findViewById(R.id.ivImage);
        llForecast = (LinearLayout) findViewById(R.id.llForecast);

        api = WeatherAPI.getClient().create(WeatherAPI.ApiInterface.class);
    }

    public void getWeather(View v) {
        Double lat = 49.22;
        Double lng = 28.409;
        String units = "metric";
        String key = WeatherAPI.KEY;

        Log.d(TAG, "OK");

        // get weather for today
        Call<WeatherDay> callToday = api.getToday(lat, lng, units, key);
        callToday.enqueue(new Callback<WeatherDay>() {
            @Override
            public void onResponse(Call<WeatherDay> call, Response<WeatherDay> response) {
                Log.e(TAG, "onResponse");
                WeatherDay data = response.body();
                //Log.d(TAG,response.toString());

                if (response.isSuccessful()) {
                    tvTemp.setText(data.getCity() + " " + data.getTempWithDegree());
                    Glide.with(MainActivity.this).load(data.getIconUrl()).into(tvImage);
                }
            }

            @Override
            public void onFailure(Call<WeatherDay> call, Throwable t) {
                Log.e(TAG, "onFailure");
                Log.e(TAG, t.toString());
            }
        });

        // get weather forecast
        Call<WeatherForecast> callForecast = api.getForecast(lat, lng, units, key);
        callForecast.enqueue(new Callback<WeatherForecast>() {
            @Override
            public void onResponse(Call<WeatherForecast> call, Response<WeatherForecast> response) {
                Log.e(TAG, "onResponse");
                WeatherForecast data = response.body();
                //Log.d(TAG,response.toString());

                if (response.isSuccessful()) {
                    SimpleDateFormat formatDayOfWeek = new SimpleDateFormat("E");
                    LayoutParams paramsTextView = new LayoutParams(
                         LayoutParams.WRAP_CONTENT,LayoutParams.WRAP_CONTENT);
                    LayoutParams paramsImageView = new LayoutParams(convertDPtoPX(40, MainActivity.this), 
                         convertDPtoPX(40, MainActivity.this));

                    int marginRight = convertDPtoPX(15, MainActivity.this);
                    LayoutParams paramsLinearLayout = new LayoutParams(LayoutParams.WRAP_CONTENT, 
                         LayoutParams.WRAP_CONTENT);
                    paramsLinearLayout.setMargins(0, 0, marginRight, 0);

                    llForecast.removeAllViews();

                    for (WeatherDay day : data.getItems()) {
                        if (day.getDate().get(Calendar.HOUR_OF_DAY) == 15) {
                            String date = String.format("%d.%d.%d %d:%d",
                                    day.getDate().get(Calendar.DAY_OF_MONTH),
                                    day.getDate().get(Calendar.WEEK_OF_MONTH),
                                    day.getDate().get(Calendar.YEAR),
                                    day.getDate().get(Calendar.HOUR_OF_DAY),
                                    day.getDate().get(Calendar.MINUTE)
                            );
                            Log.d(TAG, date);
                            Log.d(TAG, day.getTempInteger());
                            Log.d(TAG, "---");

                            // child view wrapper
                            LinearLayout childLayout = new LinearLayout(MainActivity.this);
                            childLayout.setLayoutParams(paramsLinearLayout);
                            childLayout.setOrientation(LinearLayout.VERTICAL);

                            // show day of week
                            TextView tvDay = new TextView(MainActivity.this);
                            String dayOfWeek = formatDayOfWeek.format(day.getDate().getTime());
                            tvDay.setText(dayOfWeek);
                            tvDay.setLayoutParams(paramsTextView);
                            childLayout.addView(tvDay);

                            // show image
                            ImageView ivIcon = new ImageView(MainActivity.this);
                            ivIcon.setLayoutParams(paramsImageView);
                            Glide.with(MainActivity.this).load(day.getIconUrl()).into(ivIcon);
                            childLayout.addView(ivIcon);

                            // show temp
                            TextView tvTemp = new TextView(MainActivity.this);
                            tvTemp.setText(day.getTempWithDegree());
                            tvTemp.setLayoutParams(paramsTextView);
                            childLayout.addView(tvTemp);

                            llForecast.addView(childLayout);
                        }
                    }
                }
            }

            @Override
            public void onFailure(Call<WeatherForecast> call, Throwable t) {
                Log.e(TAG, "onFailure");
                Log.e(TAG, t.toString());
            }
        });

    }

    public int convertDPtoPX(int dp, Context ctx) {
        float density = ctx.getResources().getDisplayMetrics().density;
        int px = (int)(dp * density);
        return px;
    }

}

Результат

Про Java Collections Framework: почти все и сразу

Mon, 10 Apr 2017 00:00:00 +0300

Java Collections Framework это коллекция интерфейсов и классов, которые используются для сохранения и обработки данных.

Java Collections Framework состоит из следующих компонентов:

List это упорядоченный список объектов (иногда еще называют последовательностью объектов). Элементы списка могут вставляться или извлекаться по их индексу в списке (индексация начинается с 0). В эту группу входят: ArrayList, LinkedList, Vector, Stack.
Set это не упорядоченная коллекция. Главная особенность множеств - уникальность элементов, то есть один и тот же элемент не может содержаться в множестве дважды. Есть такие имплементации Set интерфейса: HashSet, TreeSet, LinkedHashSet, EnumSet. HashSet хранит элементы в хэш-таблице, что предполагает эффективную реализацию, но не гарантирует порядок итерации элементов. TreeSet хранит элементы в красно-чёрном дереве и упорядочивает элементы по их значениям, эта коллекция существено медленее чем HashSet. LinkedHashSet реализована как хэш-таблица и хранит элементы в связаном списке, в порядке котором они были вставленны.
Map (иногда можно встретить названия: отображения, словарь, ассоциативный массив, карты) отображает ключи в значения и не может иметь дубликаты ключей. Есть три основных имплементации Map интерфейса HashMap, TreeMap и LinkedHashMap. HashMap не гарантирует воспроизводимость порядка вставки элементов. TreeMap хранит элементы в красно-чёрном дереве и упорядычивает элементы по их ключам и медленее чем HashMap. LinkedHashMap упорядычивает элементы в порядке их вставки.
Iterator/ListIterator используются для итерации элементов коллекции. Основное отличие между Iterator и ListIterator в том, что первый позволяет итерировать только в одном направлении, а второй в обоих направлениях.

Выше сказаное можно резюмировать в такой таблице

Производительность методов каждого класса можно записать через O-нотацию

Метод	Тип	Время
get, set	ArrayList	O(1)
add, remove	ArrayList	O(n)
contains, indexOf	ArrayList	O(n)
get, put, remove, containsKey	HashMap	O(1)
add, remove, contains	HashSet	O(1)
add, remove, contains	LinkedHashSet	O(1)
get, set, add, remove (с любого конца)	LinkedList	O(1)
get, set, add, remove (по индексу)	LinkedList	O(n)
contains, indexOf	LinkedList	O(n)
peek	PriorityQueue	O(1)
add, remove	PriorityQueue	O(log n)
remove, get, put, containsKey	TreeMap	O(log n)
add, remove, contains	TreeSet	O(log n)

List

ArrayList

ArrayList это массив с изменяемым количесвтом элементов (стандартный array имеет фиксированый размер), его элементы могут быть доступны непосредственно по индексу. Он реализует все операции списка и позволят вставлять все объекты, включая null. Контейнер ArrayList, оптимизированный для произвольного доступа к элементам, но с относительно медленными операциями вставки/удаления элементов в середине списка.

В случае переполнения массива появляется необходимость в новом, имеющем больше места. Размещение и перемещение всех элементов будет занимать O(n) времени. Также, необходимо добавление и удаление элементов для передвижения существующих элементов в массиве. Это, возможно, самое большое неудобство в использовании ArrayList.

Поиск в ArrayList проходит за O(1). Удаление первого элемента (худший случай) происходит за O(n), для последнего элемента (лучший случай) за O(1). Вставка происходит за O(n).

Пример

ArrayList<String> lst = new ArrayList<>();

// добавление элементов
lst.add("Mercury");
lst.add("Venus");
lst.add("Earth");
lst.add("Saturn");
lst.add("Neptune");

// добавлене несколько элементов сразу
lst.addAll(Arrays.asList("PlanetX", "PlanetY", "PlanetZ"));

// отображение массива
System.out.println(lst);

// добавление элемента в определеную позицию
lst.add(0, "Jupiter");
lst.add(1, "Uranus");

// получение True если значение есть в массиве, иначе False
boolean isExist = lst.contains("Earth")

// получение True если все значения есть в массиве, иначе False
ArrayList<String> favorite = new ArrayList<>();
favorite.add("Earth");
favorite.add("Saturn");
boolean isContains = planets.containsAll(favorite);

// удаление элемента по значению
lst.remove("Saturn");
lst.remove("Neptune");

// оставить в списке только указаные элементы
ArrayList<String> favorite = new ArrayList<>();
favorite.add("Earth");
favorite.add("Saturn");
planets.retainAll(favorite);

// отображение массива
System.out.println(lst);

// удаление элемента по индексу
lst.remove(1);

// удалить все элементы в списке
ArrayList<String> favorite = new ArrayList<>();
favorite.add("Earth");
favorite.add("Saturn");
planets.removeAll(favorite);

// удалить элементы списка, которые соответсвуют условию Predicate
class SamplePredicate<T> implements Predicate<T> {
    T varc1;
    public boolean test(T varc) {
        if(varc1.equals(varc)) {
            return true;
        }
        return false;
    }
}

SamplePredicate<String> filter = new SamplePredicate<>();
filter.varc1 = "Saturn";
planets.removeIf(filter);

// обновление значения по индекску
lst.set(1, "Neptune");

// получить индекс элемента по значению, если не найденно то -1
int pos = lst.indexOf("Jupiter");

// получение элемента по индексу
String planet = lst.get(3)

// размер массива
int amount = lst.size()

// получить часть массива
ArrayList<String> lst2 = new ArrayList<>(lst.subList(1, 3));

// обэдинение массивов
lst.addAll(lst2)

// удалить все элементы
lst.clear()

// отсортировать список в обратном порядке
List reversedList = Collections.reverse(planets);

// заменить значение каждого элемента списка на результат оператор
// оператор
class MyOperator<T> implements UnaryOperator<T>{
    T varc1;
    public T apply(T varc){
        return varc1;
    }
}

MyOperator<String> operator = new MyOperator<>();
operator.varc1 = "Earth";
planets.replaceAll(operator);
System.out.println(planets);
// [Earth, Earth, Earth, Earth]


// выполнить действие над каждым элементом списка
// действие
class MyConsumer<T> implements Consumer<T>{
    public void accept(T planet){
        System.out.println("We are flying to " + planet);
    }
}

MyConsumer<String> action = new MyConsumer<>();
planets.forEach(action);

LinkedList

LinkedList — это связанный список ссылок на элементы. Таким образом, для доступа к элементу в центре, приходится производить поиск с самого начала и до конца листа. С другой стороны, добавление и удаление элемента в LinkedList быстрее (чем в ArrayList) по той причине, что эти операции лишь изменяют сам список.

Контейнер LinkedList, оптимизированный для последовательного доступа, с быстрыми операциями вставки/удаления в середине списка. Произвольный доступ к элементам LinkedList выполняется относительно медленно, т.к. требует полного перебора элементов. Класс представляет структуру данных связного списка и реализует интерфейсы List, Dequeue, Queue.

Поиск в LinkedList проходит за O(n). Удаление происходит за O(1). Вставка происходит за O(1).

Пример

LinkedList<String> lst = new LinkedList<>();

// добавление элементов
lst.add("Mercury");
lst.add("Earth");
lst.addLast("Saturn");
lst.addFirst("Neptune");
lst.add(1, "Venus");

// вставка в начало
lst.push("Kopernik")

// отображение списка
System.out.println(lst);

// добавлене несколько элементов сразу
lst.addAll(Arrays.asList("PlanetX", "PlanetY", "PlanetZ"));

// изменить элемент списка по индексу
String planet = lst.set(1, "PlanetA")

// получение True если значение есть в списке, иначе False
boolean isExist = lst.contains("Earth")

// получение элемента по индексу
String planet = lst.get(3)

// получение первого элемента
String planet = lst.getFirst()

// получение последнего элемента
String planet = lst.getLast()

// получить все элементы списка в виде массива
String[] planets = lst.toArray()

// удалить все элементы
lst.clear()

// получить индекс первого элемента с указаным значением, если не найденно то -1
int pos = lst.indexOf("Jupiter");

// получить индекс последнего элемента с указаным значением, если не найденно то -1
int pos = lst.lastIndexOf("Jupiter");

// удаление первого элемента со значением
lst.remove("PlanetX");

// удалить первый элемент из списка и вернуть значение
String planet = lst.removeFirst();

// удалить первый элемент из списка и вернуть значение
String planet = lst.poll();

// удалить первый элемент из списка и вернуть значение
String planet = lst.pop();

// удалить последний элемент из списка и вернуть значение
String planet = lst.removeLast();

// размер списка
int amount = lst.size()

// перебор элементов списка
for(String str: lst) {
  System.out.println(str);
}

// быстрый способ добавить/объединить списки
String[] morePlanets = {"Planet1", "Planet2", "Planet3"};
Collections.addAll(lst, moreInts);

// конвертирование LinkedList в ArrayList
List<String> arr = new ArrayList<>(lst);

Сравнение LinkedList и ArrayList по скорости операций:

Метод	Arraylist	LinkedList
get(index)	O(1)	O(n)
add(E)	O(n)	O(1)
add(E, index)	O(n)	O(n)
remove(index)	O(n)	O(n)
Iterator.remove()	O(n)	O(1)
Iterator.add(E)	O(n)	O(1)

Сравнеие производительности Arraylist и LinkedList

Vector

Vector это динамический массив, похожий на ArrayList, за исключением двух моментов: Vector синхронизирован (потоко-безопасен) и Vector содержит много legacy-методов. По умолчанию, Vector удваивает свой размер когда заканчивается выделенная под элементы память. ArrayList же увеличивает свой размер только на половину.

Stack

Стэк является подкласом Vector и работает по принципу LIFO (last-in-first-out rule) - последним пришел, первым ушел. Обратите внимание, что Stack и Vector оба потокобезопасны. Используйте стэк если вы хотите вставлять и удалять элементы только с вершины стэка, что полезно в рекурсивных алгоритмах.

Пример

Stack<String> planets = new Stack<>();

// добавление элементов
planets.push("Mercury");
planets.push("Earth");
planets.push("Saturn");

// вывод стэка
System.out.println(planets);

// пустой стэк?
boolean isEmpty = planets.empty()

// получить вершину стэка, без удаления
String top = planets.peek();
System.out.println(top);

// получить вершину стэка, с удалением
String saturn = planets.pop();
System.out.println(saturn);

// поиск элемента в стэке (вызов метода equals() для каждого элемента)
int index = planets.search("Earth");
System.out.println(index);

Set

HashSet, TreeSet и LinkedHashSet относятся к семейству Set. В множествах Set каждый элемент хранится только в одном экземпляре, а разные реализации Set используют разный порядок хранения элементов. В HashSet порядок элементов определяется по сложному алгоритму и не гарантирует порядок в котором элементы вставлялись. Если порядок хранения для вас важен, используйте контейнер TreeSet, в котором объекты хранятся отсортированными по возрастанию в порядке сравнения или LinkedHashSet с хранением элементов в порядке добавления.

Множества часто используются для проверки принадлежности, чтобы вы могли легко проверить, принадлежить ли объект заданному множеству, поэтому на практике обычно выбирается реализация HashSet, оптимизированная для быстрого поиска.

Сравним времени на операцию add() для HashSet, TreeSet, LinkedHashSet.

HashSet

HashSet расширяет AbstractSet и реализует интерфейс Set. HashSet создает коллекцию, которая использует хеш-таблицу для сохранения своих значений. Класс Object и его наследники имеют метод hashCode(), который используется классом HashSet для эффективного размещения объектов, заносимых в коллекцию. Ключ используется для определения уникальности элемента и называется хеш-кодом.

Особености HasSet:

HashSet не поддерживает порядок своих элементов, а это значит, что элементы будут возвращены в любом порядже.
HashSet не разрешает хранить дубликаты. Если вы добавите существующий элемент, то старое значение будет переписано.
HashSet разрешает добавить в колекцию null значение, но только одно значение.
HashSet не синхронизировано.

Пример

HashSet<String> planets = new HashSet<>();

// добавление элементов
planets.add("Mercury");
planets.add("Earth");
planets.add("Saturn");
planets.add("Neptune");
planets.add("Venus");

// отображение множества, обратите внимание на порядок вывода
System.out.println(planets);

// получение True если значение есть в множестве, иначе False
boolean isExist = planets.contains("Earth")

// пустое множество?
boolean isEmpty = planets.isEmpty()

// удаление элемента по значению
planets.remove("Saturn");

// удалить все элементы
planets.clear()

// размер множества
int amount = planets.size()

// перебор элементов множества
for(String str: planets) {
  System.out.println(str);
}

// конвертирование HashSet в ArrayList
List<String> arr = new ArrayList<>(planets);

// конвертирование List в Set
Set<Integer> set = new HashSet<>(list);

// конвертирование List в Set, если надо учитывать сравнение элементов
Set<Integer> set = new TreeSet<>(aComparator);
set.addAll(list);

LinkedHashSet

Класс LinkedHashSet расширяет класс HashSet, не добавляя никаких новых методов. Класс поддерживает связный список элементов множества в том порядке, в котором они вставлялись.

Пример

LinkedHashSet<String> planets = new LinkedHashSet<>();

// добавление элементов
planets.add("Mercury");
planets.add("Earth");
planets.add("Saturn");
planets.add("Neptune");

// отображение множества, обратите внимание на порядок вывода
System.out.println(planets);

TreeSet

TreeSet реализует интерфейс SortedSet.

Класс TreeSet создаёт коллекцию, которая для хранения элементов использует дерево. Объекты сохраняются в отсортированном порядке по возрастанию.

Время доступа к элементам небольшое, что делает TreeSet отличным выбором для сохранения большого количкства отсортироыанных данных и к которым должен быть обеспечен быстрый доступ.

TreeSet не поддерживает хранение элементов типа null.

Пример

TreeSet<String> planets = new TreeSet<>();

// добавление элементов
planets.add("Mercury");
planets.add("Earth");
planets.add("Saturn");
planets.add("Neptune");
planets.add("Venus");

// добавлене несколько элементов сразу
planets.addAll(Arrays.asList("PlanetX", "PlanetY", "PlanetZ"));

// отображение множества, обратите внимание на порядок вывода
System.out.println(planets);

// получение True если значение есть в множестве, иначе False
boolean isExist = planets.contains("Earth")

// пустое множество?
boolean isEmpty = planets.isEmpty()

// получить первый элемент
String planet = planets.first();

// получить последний элемент
String planet = planets.last();

// получить все элементы перед указаным
Set planetsBefore = planets.headSet("Neptune");

// получить все элементы после указаного
Set planetsAfter = planets.tailSet("Neptune");

// получить все элементы между двумя указаными
Set planetsSub = planets.subSet("Mercury", "Venus");

// удаление элемента по значению
planets.remove("Saturn");

// удалить все элементы
planets.clear()

// размер множества
int amount = planets.size()

// перебор элементов множества
for(String str: planets) {
  System.out.println(str);
}

// получить индекс элемента
int pos = planets.headSet("Neptune").size()

// определим произволный Comparator для TreeSet
Set planets2 = new TreeSet<>(new Comparator<String>() {
    @Override
    public int compare(String o1, String o2) {
        // define comparing logic here
        return Integer.compare(o1.length() , o2.length());
    }
});

planets2.add("Earth");
planets2.add("Saturn");
planets2.add("Neptune");

System.out.println(planets2);

NavigableSet

Интерфейс NavigableSet наследуется от SortedSet и предоставляет возможность навигации по множеству в обоих направлениях.

Пример

NavigableSet<String> planets = new TreeSet<>();

// добавление элементов
planets.add("Mercury");
planets.add("Earth");
planets.add("Saturn");
planets.add("Neptune");
planets.add("Venus");

// печать множества
System.out.println(planets);

// обратный порядок
NavigableSet<String> planetsReverse = planets.descendingSet();
System.out.println(planetsReverse);

// получить два последних элемента
NavigableSet<String> twoLast = planets.tailSet("Saturn", true);
System.out.println(twoLast);

// получить элемент, который перед указанным
String lower = planets.lower("Saturn");
System.out.println(lower);

// получить элемент, который после указаного
String higher = planets.higher("Saturn");
System.out.println(higher);

// получить первый элемент и удалить его из множества
String first = planets.pollFirst();

// получить последний элемент и удалить его из множества
String last = planets.pollLast();

Queue

Очереди предствляют собой упорядоченый список элементов, т.к. реализуют интерфейс List, но есть особености использования. Элементы вставляются в конец очереди, а извлекаются из начала очереди. Обычно, но не обязательно, очереди работают по принципу FIFO — первым пришел, первым ушел.

Используйте очередь если вы хотите обрабатывать поток элементов в том же порядке в котором они поступают. Хорошо для списка заданий и обработки запросов.

Queue

В Java Collections API интерфейс Queue реализован в

LinkedList - реализует принцип FIFO.
PriorityQueue - хранит элементы либо в естественном порядке (natural order) либо в соответсвии с Comparator, переданым в конструктор.

Пример

Queue<String> planets = new LinkedList<>();

// добавление элементов
planets.add("Mercury");
planets.add("Earth");
planets.add("Saturn");

// добавить элемент, в случаи проблемы - выбросить exception
planets.add("Neptune");

// добавить элемент, в случаи проблемы - вернуть false
planets.offer("Venus");

// получить последний элемент очереди, без удаления
String top = planets.element();
System.out.println(top);

// получить последний элемент очереди, с удалением
String saturn = planets.remove();
System.out.println(saturn);

// итерация элементов
for(String planet : planets) {
    System.out.println(planet);
}

Deque

Deque (Double Ended Queues) это двухсторонняя очередь, которая позволяет вставлять/удалять элементы как с конца очереди, так и с начала. Deque интерфейс расширяет Queue интерфейс.

В Java Collections API интерфейс Deque реализован в

ArrayDeque - базируется на массиве и используется при реализации стэка (принцип LIFO).
LinkedList - базируется на двух-связном списке и используется при реализации очереди (принцип FIFO).

Пример

Deque<String> planets = new LinkedList<>();

planets.addLast("Mercury");
planets.offerLast("Earth");
planets.offerLast("Saturn");
planets.offerLast("Venus");
System.out.println(planets);

// пустая очередь?
boolean isEmpty = planets.isEmpty()

// итерация по очереди и извлечение по одному элементу
while (planets.peekFirst() != null) {
  System.out.println("Первый элемент: " + planets.peekFirst());
  planets.removeFirst();
  System.out.println("Очередь: " + planets);
}

// получить первый элемент очереди, без удаления
String top = planets.peekFirst();
System.out.println(top);

// получить первый элемент очереди, с удалением
String saturn = planets.pollFirst();
System.out.println(saturn);

Map

В контейнерах Map (отображения, словарь, ассоциативный массив, карты) хранятся два объекта: ключ и связанное с ним значение. Map позволяет искать объекты по ключу. Объект, ассоциированный с ключом, называется значением. И ключи, и значения являются объектами. Ключи могут быть уникальными, а значения могут дублироваться. Некоторые отображения допускают пустые ключи и пустые значения.

Интерфейс Map соотносит уникальные ключи со значениями. Ключ - это объект, который вы используете для последующего извлечения данных. Задавая ключ и значение, вы можете помещать значения в объект отображения. После того как это значение сохранено, вы можете получить его по ключу.

Основные методы - get() и put(), чтобы получить или поместить значения в отображение.

Интерфейс Map предоставляет три представления (view) хранящихся данных:

множество всех ключей
множество всех значений
множество объектов Entry, содержащих в себе и ключ и значение

Отображения не поддерживают реализацию интерфейса Iterable, поэтому нельзя перебрать карту через цикл for в форме for-each. Можно перебрать отдельно ключи или значения или объекти Entry.

Интерфейс SortedMap расширяет интерфейс Map и гарантирует, что элементы размещаются в возрастающем порядке значений ключей.

Интерфейс NavigableMap расширяет интерфейс SortedMap и определяет поведение отображения, поддерживающее извлечение элементов на основе ближайшего соответствия заданному ключу или ключам.

Интерфейс Map.Entry позволяет работать с элементом отображения, в частности используется при переборе элементов. Основные мотеды интерфейса Map.Entry

equals(Object o) сравнение на равенство двух элементов
getKey() получить ключ элемента
getValue() получить значение элемента
hashCode() получить хэш-код элемента
setValue(V value) замена значения элемента на value

HashMap

HashMap использует хэш-таблицу для реализации Map интерфейса, что позволяет операциям get() и put() выполнятся за константное время даже для больших наборов. HashMap обеспечивает максимальную скорость выборки, а порядок хранения его элементов не очевиден.

HashMap подобен Hashtable с нескольками исключениямия:

HashTable потокобезопасна, а HashMap нет
HashTable не может содержать элементы null, тогда как HashMap может содержать один ключ null и любое количество значений null
Итератор у HashMap, в отличие от перечислителя HashTable, работает по принципу fail-fast (выдает исключение при любой несогласованности данных)

Пример

HashMap<String, Double> planets = new HashMap<>();

// добавление элементов
planets.put("Mercury", new Double(2439.7));
planets.put("Earth", new Double(6371));
planets.put("Saturn", new Double(58232));
planets.put("Neptune", new Double(24622));
planets.put("Venus", new Double(6051.8));

// отображение множества, обратите внимание на порядок вывода
System.out.println(planets);

// получить значение по ключу
Double radius = planets.get("Earth");

// получение True если ключ есть в отображении, иначе False
boolean isExist = planets.containsKey("Earth")

// получение True если значение есть в отображении, иначе False
boolean isExist = planets.containsValue("Earth")

// пустое отображение?
boolean isEmpty = planets.isEmpty()

// удаление элемента по ключу
planets.remove("Saturn");

// список ключей
Set keys = planets.keySet();

// список значений
Collection<Double> values = planets.values();
ArrayList<Double> arr = new ArrayList<>(planets.values());

// множество элементов ввиде объектов интерфейса Map.Entry
Set entries = planets.entrySet();

// перебор элементов Entry отображения с помощью for
for (Map.Entry me : planets.entrySet()) {
  System.out.println("Key: "+me.getKey() + " & Value: " + me.getValue());
}

// перебор элементов отображения с помощью while
Set entries = planets.entrySet();
Iterator i = entries.iterator();

while(i.hasNext()) {
    Map.Entry me = (Map.Entry)i.next();
    System.out.print(me.getKey() + ": ");
    System.out.println(me.getValue());
}

// размер отображения
int amount = planets.size()

// удалить все элементы
planets.clear()

// конвертирование Map в ArrayList: список ключей
List keyList = new ArrayList(planets.keySet());

// конвертирование Map в ArrayList: список значений
List valueList = new ArrayList(planets.valueSet());

// конвертирование Map в ArrayList: список ключ-значения
List entryList = new ArrayList(planets.entrySet());

// упорядочивание Map по значениям
List list = new ArrayList(planets.entrySet());
Collections.sort(list, new Comparator() {
   @Override
  public int compare(Entry e1, Entry e2) {
    return e1.getValue().compareTo(e2.getValue());
  }
});

TreeMap

TreeMap реализует Map интерфейс с помощью структуры красно-чёрного дерева и хранит ключи отсортированными по возрастанию (естественный порядок, natural order). Переопределить сортировку можно предоставив экземпляр класса Comparator, метод compare которого и будет использован для сортировки ключей. Обратите внимание, что все ключи добавленные в словарь должны реализовывать интерфейс Comparable (это необходимо для сортировки).

TreeMap предоставляет быстрый доступ к своим элементам.

Для вставки, удаления и поиска элементов в Map лучше использовать HashMap. Если же нужно последовательно обходить карты в неком порядке то лучше использовать TreeMap. Иногда, в зависимости от размера коллекции, лучше добавить элементы в HashMap, а потом сконвертировать в TreeMap для упорядоченого обхода элементов.

Пример

TreeMap<String, Double> planets = new TreeMap<>();

// добавление элементов
planets.put("Mercury", new Double(2439.7));
planets.put("Earth", new Double(6371));
planets.put("Saturn", new Double(58232));
planets.put("Neptune", new Double(24622));
planets.put("Venus", new Double(6051.8));

// отображение множества, обратите внимание на порядок вывода
System.out.println(planets);

// получить значение по ключу
Double radius = planets.get("Earth");

// получение True если ключ есть в отображении, иначе False
boolean isExist = planets.containsKey("Earth")

// получение True если значение есть в отображении, иначе False
boolean isExist = planets.containsValue("Earth")

// пустое отображение?
boolean isEmpty = planets.isEmpty()

// удаление элемента по ключу
planets.remove("Saturn");

// список ключей
Set keys = planets.keySet();

// список значений
Collection<Double> values = planets.values();
ArrayList<Double> arr = new ArrayList<>(planets.values());

// множество элементов ввиде объектов интерфейса Map.Entry
Set entries = planets.entrySet();

// перебор элементов отображения с помощью for
for (Map.Entry me : planets.entrySet()) {
  System.out.println("Key: "+me.getKey() + " & Value: " + me.getValue());
}

// перебор элементов отображения с помощью while
Set entries = planets.entrySet();
Iterator i = entries.iterator();

while(i.hasNext()) {
    Map.Entry me = (Map.Entry)i.next();
    System.out.print(me.getKey() + ": ");
    System.out.println(me.getValue());
}

// размер отображения
int amount = planets.size()

// удалить все элементы
planets.clear()

// сортировка элементов по значению
// компаратор
public static <K, V extends Comparable<V>> Map<K, V>  sortByValues(final Map<K, V> map) {
    Comparator<K> valueComparator = new Comparator<K>() {
        public int compare(K k1, K k2) {
            int compare =  map.get(k1).compareTo(map.get(k2));
            if (compare == 0)
                return 1;
            else
                return compare;
        }
    };

    Map<K, V> sortedByValues = new TreeMap<K, V>(valueComparator);
    sortedByValues.putAll(map);
    return sortedByValues;
}

Map sortedMap = sortByValues(planets);
for (Map.Entry me : sortedMap.entrySet()) {
    System.out.println("Key: "+me.getKey() + " & Value: " + me.getValue());
}

LinkedHashMap

LinkedHashMap реализует связанный список элементов отображения и хранит ключи в порядке вставки. Также позволяет сортировать элементы в порядке последнего доступа. LinkedHashMap не обеспечивает скорость поиска как HashMap.

Пример

LinkedHashMap<String, Double> planets = new LinkedHashMap<>();

// добавление элементов
planets.put("Mercury", new Double(2439.7));
planets.put("Earth", new Double(6371));
planets.put("Saturn", new Double(58232));
planets.put("Neptune", new Double(24622));
planets.put("Venus", new Double(6051.8));

// отображение множества, обратите внимание на порядок вывода
System.out.println(planets);

// получить значение по ключу
Double radius = planets.get("Earth");

// получение True если ключ есть в отображении, иначе False
boolean isExist = planets.containsKey("Earth")

// получение True если значение есть в отображении, иначе False
boolean isExist = planets.containsValue("Earth")

// перебор элементов отображения с помощью for
for (Map.Entry me : planets.entrySet()) {
  System.out.println("Key: "+me.getKey() + " & Value: " + me.getValue());
}

// еще один вариант перебора элементов отображения с помощью for
for (Map.Entry me : planets.entrySet()) {
    String key = me.getKey();
    Double value = me.getValue();
    System.out.println("Key: " + key + " & Value: " + value);
}

Различия между Iterator и ListIterator?

Iterator может использоваться для перебора элементов Set, List и Map. В отличие от него, ListIterator может быть использован только для перебора элементов коллекции List.
Iterator позволяет перебирать элементы только в одном направлении, при помощи метода next(). Тогда как ListIterator позволяет перебирать список в обоих направлениях, при помощи методов next() и previous().
При помощи ListIterator вы можете модифицировать список, добавляя/удаляя элементы с помощью методов add() и remove(). Iterator не поддерживает данного функционала.

Как получить координаты маршрута между двумя городами в Python

Sat, 18 Mar 2017 00:00:00 +0200

Представим, что нам нужно получить координаты маршрута между Винницей и Одессой. Для этого воспользуемся Google Directions API и модулем googlemaps.

Установка

pip install -U googlemaps

Предварительно нужно получить API KEY для используемого проекта.

Запрос к Directions API для получения маршрута.

import googlemaps
from datetime import datetime

now = datetime.now()
gmaps = googlemaps.Client(key='API_KEY')
result = gmaps.directions("Vinnytsia, Ukraine", "Odessa, Ukraine", mode="transit", departure_time=now)
raw = result[0]['overview_polyline']['points']

Но вот незадача, координы хранятся не в виде широты и долготы, а в виде следующей последовательности }wjiGtd. Нам поможет модуль polyline.

Установка

pip install -U polyline

Использование

import polyline
points = polyline.decode(raw)

В points список кортежей с координатами, который можем передать в Google Maps Static.

coordinates = "|".join(["{0},{1}".format(p[0], p[1]) for p in points])
url = "http://maps.googleapis.com/maps/api/staticmap?size=800x800&path={0}".format(coordinates)

pathlib: удобное формирование путей в файловой системе

Tue, 19 Jul 2016 00:00:00 +0300

В python 3 есть полезный модуль pathlib для формирование путей в файловой системе.

Сравните пример

# python 2

import os

directory = "/home/user/temp/"
filepath = os.path.join(directory, "data.csv")

if os.path.exists(filepath):
    print('exist')

# python 3

from pathlib import Path

directory = Path("/home/user/temp/")
filepath = directory / "data.csv"

if filepath.exists():
    print('exist')

Для python 2 можно установить командой pip2 install pathlib.

Получить домашний каталог текущего пользователя

Path.home()

Разбить путь на части

from pathlib import PurePath
PurePath("/home/user/temp/").parts
# ('/', 'home', 'user', 'temp')

Записать строку в файл и закрыть файл

p = Path('hw.txt')
p.write_text('Hello world')

Прочитать строку из файла

p = Path('hw.txt')
line = p.read_text()

Еще пример

> from pathlib import Path
> p = Path("/usr/lib/python2.5/gopherlib.py")
> p.parent
PosixPath('/usr/lib/python2.5')
> p.name
'gopherlib.py'
> p.suffix
'.py'
> p.stem
'gopherlib'

Описание тут.

Локальная отладка рассылки с помощью MailDev

Sat, 14 May 2016 00:00:00 +0300

MailDev позволяет локально поднять SMTP сервер для тестирования и отладки почтовой рассылки. Присутствуют и другие приятные бонусы:

веб-интерфейс для просмотра входящих
просмотр текстового и html вида письма, а также заголовков
просмотр аттачей
автоматическое обновлений в веб-интерфейсе
настройка с командной строки ;)

Установка и запуск

sudo npm install -g maildev
maildev

Веб-морда доступна по адресу http://0.0.0.0:1080.

Настройки для Django

EMAIL_HOST = '0.0.0.0'
EMAIL_PORT = '1025'

Настройки для MeteorJS

# через переменную окружения
export MAIL_URL='smtp://0.0.0.0:1025'

# или в серверной части
Meteor.startup( function() {
    process.env.MAIL_URL = 'smtp://0.0.0.0:1025';
});

Пример работы с перечислениями (enum) в Java

Sun, 29 Mar 2015 00:00:00 +0200

Информация в посте приведена на основе книги Эккель Б. Философия Java (4-е издание)

Ключевое слово enum создает новый тип с ограниченным набором именованных значений, и работать с этими значениями можно как с обычными компонентами программы.

Мы можем получить список констант перечисления, вызвав для enum метод values(). Метод values() создает массив констант перечисления, следующих в порядке их объявления, так что полученный массив может использоваться в цикле foreach.

При создании перечисления компилятор генерирует соответствующий класс. Этот класс автоматически наследует от класса java.lang.Enum. Элементы enum это статически доступные экземпляры enum-класса. Некоторые полезные возможности базового класса продемонстрированы в следующем примере:

class Example1{  
    public enum Season {WINTER, SPRING, SUMMER, FALL};

    Season w = Season.WINTER;

    public static void main(String[] args) {  
        for (Season s : Season.values())  
            System.out.println(s.ordinal() + ": " + s);  
    }  
}

Метод ordinal() возвращает значение int, определяющее порядок объявления экземпляров перечисления начиная с нуля. Экземпляры всегда можно безопасно сравнивать с оператором ==, a методы equals() и hashCode() автоматически создаются за вас. Класс Enum реализует интерфейс Comparable, поэтому в нем присутствует метод compareTo( ), кроме того, реализуется интерфейс Serializable.

Метод name() возвращает имя точно в таком виде, в каком оно было объявлено; эту же информацию возвращает метод toString(). Статический метод valueOf() возвращает экземпляр перечисления, соответствующий переданному строковому имени, или возбуждает исключение при отсутствии подходящего экземпляра.

Пример получения элемент enum по его строковому представлению

String name = "SUMMER"; 
Season season = Season.valueOf(name);

Перечисление не может использоваться при наследовании, но в остальном оно работает как обычный класс. Это означает, что в перечисление можно добавлять новые методы.

Допустим, вы решили определить для перечисления другое описание - вместо реализации toString() по умолчанию, которая просто выдает имя экземпляра перечисления. Для этого можно предоставить конструктор для сохранения расширенной информации, a также дополнительные методы для передачи расширенного описания:

class Example2{  
    public enum Season {
        WINTER("Cold season"), 
        SPRING("Cool season"), 
        SUMMER("Hot season"), 
        FALL("Cool season");

        private String description;

        private Season(String description) {
            this.description = description;
        }

        public String getDescription() {return description;}
    };

    public static void main(String[] args) {  
        for (Season s : Season.values())  
            System.out.println(s + ": " + s.getDescription());  
    }  
}

Обратите внимание: если вы собираетесь определять методы, то последовательность экземпляров перечисления должна завершаться символом ;. Кроме того, по правилам Java перечисление должно начинаться с определения экземпляров. При попытке определить их после методов или полей компилятор выдает ошибку.

Конструктор и методы строятся пo той же схеме, что и в обычном классе‚ потому что перечисление (с некоторыми ограничениями) и является обычным классом.

Одна из самых удобных возможностей перечисления связана с их использованием в команде switch.

class Example3{  
    public enum Season {WINTER, SPRING, SUMMER, FALL};

    public static void main(String[] args) {  
        Season w = Season.WINTER;
        switch(w) {
            case WINTER:
            case SPRING:
            case FALL:
                System.out.println("Working ...");  
                break;
            case SUMMER:
                System.out.println("Relaxation ...");  
                break;

        }
    }  
}

Разница между ArrayList и LinkedList

Wed, 29 Oct 2014 00:00:00 +0200

Контейнер List гарантирует хранение списка элементов в определенной последовательности. Интерфейс List добавляет в Collection методы вставки и удаления элементов в середине списка.

Существуют две основные разновидности List:

Базовый контейнер ArrayList с превосходной скоростью произвольного доступа к элементам, но относительно медленными операциями вставки и удаления элементов в середине.
Связанный список LinkedList с оптимальным последовательным доступом и низкозатратными операциями вставки и удаления в середине списка. Операции произвольного доступа LinkedList выполняет относительно медленно, но обладает более широкой функциональностью, чем ArrayList.

Пример работы с ArrayList

ArrayList al = new ArrayList();

al.add("C");
al.add("A");
al.add("E");
al.add("F");
al.add(1, "A2");

System.out.println("Содержимое al: " + al);

al.remove("F");
al.remove(2);

Класс LinkedList, как и ArrayList, реализует базовый интерфейс List, но при этом выполняет некоторые операции (вставка и удаление в середине списка) более эффективно, чем ArrayList. И наоборот, с операциями произвольного доступа он работает менее эффективно.

В LinkedList также добавляются методы, которые позволяют использовать его как стек, очередь или двустороннюю очередь (дек).

Некоторые из этих методов представляют собой синонимы или небольшие видоизменения для создания имен, более знакомых в контексте конкретного применения (прежде всего Queue). Например, методы getFirst() и element() идентичны - они возвращают начало (первый элемент) списка без его удаления и выдают исключение NoSuchElementException, если список пуст.

Метод addFirst() вставляет элемент в начало списка.

Метод offer() делает то же, что add() и addLast(). Все эти методы добавляют элемент в конец списка.

Метод removeLast() удаляет и возвращает последний элемент списка.

Пример работы с LinkedList

LinkedList ll = new LinkedList();

ll.add("F");
ll.add("B");
ll.add("D");
ll.add("E");
ll.add("C");
ll.addLast("Z");
ll.addFirst("A");
ll.add(1, "A2");
System.out.println("Содержимое ll: " + ll);

// удаление элементов
ll.remove("F");
ll.remove(2);
System.out.println("Содержимое ll: " + ll);

// удалить первый и второй элемент 
ll.removeFirst();
ll.removeLast();
System.out.println("Содержимое ll: " + ll);

Почти все банкоматы Украины на карте вашего Android'a

Sat, 26 Jul 2014 00:00:00 +0300

Наверное у многих была ситуация, когда нужно снять деньги с карточки а вы не знаете где ближайший банкомат. Если вас такая ситуация застала в родном городе то особо не беда, можно добраться до ближайшего банкомата/банка про который вы знаете. А если такая ситуация возникла в городе, в которым вы плохо ориентируетесь?

Вот из такой цепочки соображений возникла идея для сайта safemoney.com.ua и Android-приложения.

Мое описание с Google play

Список адресов банкоматов и филиалов украинских банков. Есть возможность отобразить все адреса на карте и показать банкоматы возле Вас.

На данный момент доступны банкоматы и филиалы для всех областных центров (кроме Луганска, Донецка и Крым АР). Всего 51 банк с 12652 банкоматами и филиалами.

Проект развивается на бесплатной основе, потому приветствуются желающие помочь в наполнении базы :).

На стороне сервера трудиться Django + Django REST framework. Почему Django, а не, скажем Flask, Tornado, etc.? Тут было интересней разобраться со связкой Android-приложение + REST, чем заниматься оптимизацией backend'a и что не мало важно в Django уже есть из коробки админка, orm, sitemap.

База используется PostgreSQL, хотя это не принципиально. Что-то особого из гео-кодирования пока не используется, только координаты широты и долготы. Сами координаты получаю с помощью замечательного модуля geopy.

Пример

from geopy.geocoders import GoogleV3
geolocator = GoogleV3()
address, (latitude, longitude) = geolocator.geocode("Украина, Винница, ул. Пирогова 1")
print(address, latitude, longitude)
(u"Pyrohova street, 1, Vinnytsia, Vinnyts'ka oblast, Ukraine", 49.232661, 28.457728)

Если есть желающие сделать iOS клиент и у вас есть возможность опубликовать в App Store, то пишите тут в комментариях или напрямую через контакты. По сути, приложение это набор ListView с запросами к REST и отображение результатов запроса на Google Map. Желательно кэшировать результат запроса в локальное хранилище устройства, что бы не дергать сервер на каждый чих или если проблемы с доступом к интернету. Для желающих доступ к API предоставлю.

Пробую Mac OS X ... кисловато

Mon, 07 Jul 2014 00:00:00 +0300

Раньше я особо не высказывался по поводу продукции Apple, т.к. она была мне мало интересна до недавнего момента, пока у меня не появился Mac mini. Вокруг меня много людей с полярными взглядами на яблочную продукцию, кто-то фанатеет до потери пульса и пускает слюни на каждый новый гаджет или софт :), а кто-то не упускает момента что-бы не кинуть камень в их огород.

Попробовав поработать с OS X 10.9 около двух недель, хочу поделиться своим впечатлением и настройками, вдруг когда-то еще пригодятся. Немного про мой беграунд и с какой позиции я буду судить :), 12 лет я прожил под Windows (начиная с 95 и до 7-ки, на семерку меня хватило около 2-х недель ... мигрировал на ubuntu) и 6 лет под Linux (RedHat, Mandriva, Ubuntu, CentOS, ArchLinux).

Пройдусь по пунктам что мне не понравилось:

Рендринг шрифтов. Мои глаза абсолютно его не восприняли и через полчаса начали пекти :(. А это, согласитесь, не совместимо с комфортной работой. Скриншот рендринга шрифтов в OS X и ArchLinux смотрите ниже, это веб-морда почты от i.ua в Chrome. Под арчем шрифты значительно четче и приятней для чтения! Попытка играться с командой defaults -currentHost write -globalDomain AppleFontSmoothing -int 1 не дала результата. Насколько я понял в OS X вообще нельзя отключить/ослабить сглаживание шрифтов (anti-aliasing) или можно? если кто-то знает напишите плиз в комментариях. В iTerm2, Sublime Text, PyCharm это дело отключается и можно комфортно работать, в остальных приложениях, что я использую, такой опции нет :(.
Отваливается wifi с одним из dlink-роутеров, хотя остальные 7 девайсов работает нормально. Позабавила встроенная утилита для просмотра сетевых интерфейсов networksetup -listallnetworkservices, в частности, её любовь к длинным ключам :) ... не сравнимо с ip a под Linux.
Finder не умеет (!) отображать сначала директории а потом файлы. Нету быстрого способа показать/скрыть скрытые файлы. Нету возможности вырезать файл. Нужно либо искать другой файловый менеджер или ставить надстройки над Finder, я нашел бесплатный xtrafinder. Если xtrafinder и добавит в Finder возможность отображать сначала директории а потом файлы то в диалоговых окнах Открыть/Сохранить по-прежнему будет каша (!).
Клавиши Home/End не везде работают как на PC. Нужно искать что-то, что вернет этим клавишам привычный функционал, например, KeyRemap4MacBook.
Если приложение минимизировать через кнопки управления в заголовке, то это приложение по cmd+tab развернуть нельзя уже. Зачем так сделано?
Есть под OS X такой популярный и бесплатный менеджер буферов обменов как ClipMenu. Вроде и богат функционалом и красив, но зачем разбивать элементы по группам? Кроме того что не понятно в какой группе текст так еще лишнее движение на выбор группы (или поиск группы, в которой находиться нужный текст). Неудобно!
Позабавил принцип установки некоторых приложений: drug-n-drop в папку Applications, шикарно :) (сарказм).

Теперь с чистой совестью можно перейти к установке джентльменского набора приложений.

Для начала нам понадобиться Xcode, это можно сделать либо с помощью команды в терминале

xcode-select --install

или поискав в App Store.

Менеджер пакетов brew

Для установки дополнительного софта воспользуемся brew

ruby -e "$(curl -fsSL https://raw.github.com/mxcl/homebrew/go/install)"

Проверим наше окружение для совместимости с brew

brew doctor

Следующая команда обновит brew и список пакетов

brew update

Список команд brew

brew install python - установка пакета python
brew uninstall python - удаление пакета python
brew update - обновить brew
brew upgrade python - обновление пакета python
brew info python - информация о пакете python
brew list - список установленных пакетов

Все пакеты устанавливаются в /usr/local/Cellar/.

Дополнительные приложения можно устанавливать не только с помощью brew, есть еще много разных других менеджеров пакетов: MacPorts, Fink и Rudix.

Установка zsh

Установим zsh с помощью brew

brew install zsh zsh-completions

Подключим oh-my-zsh

cd $HOME
git clone https://github.com/robbyrussell/oh-my-zsh.git .oh-my-zsh
cp ~/.oh-my-zsh/templates/zshrc.zsh-template ~/.zshrc

Сделаем zsh шелом по-умолчанию для текущего пользователя

chsh -s /usr/local/bin/zsh

Активируем установленные дополнения, добавив следующие в ~/.zshrc

fpath=(/usr/local/share/zsh-completions $fpath)

Активируем полезные плагины от oh-my-zsh, добавив следующею строчку в ~/.zshrc

plugins=(git pip django postgres history history-substring-search brew sublime)

Можем поменять тему, полный список тем смотрим тут

ZSH_THEME="bobbyrussell"

Еще можем подключить тёмный Solarized.

Установка vim

Установка

brew install vim macvim

Установим Vundle

git clone https://github.com/gmarik/Vundle.vim.git ~/.vim/bundle/vundle

Подтяним свой конфиг (пример моего)

ln -s ~/reps/dotfiles/.vimrc ~/

Запустим vim и обновим плагины :PluginInstall.

Дополнительный софт

Установим git, ack, wget, curl

brew install git ack wget curl

Набор приложений, для установки которых надо будет скачать вручную и запустить

iTerm2 - терминал
Chrome - браузер
Firefox - браузер
Skype - сообщения, видео связь
Adium - jabber клиент
Dropbox - синхронизация файлов
Transmission - BitTorrent клиент
LibreOffice - офис
Sublime Text 3 - текстовый редактор, настройка Sublime. Если не работают клавиши Home и End то читать тут.
PyCharm - IDE для python/django/flask/etc
ClipMenu - менеджер буферов обмена
MLSwitcher - менеджер переключения языков
The Unarchiver - разархиватор, ссылка на App Store
MenuMeters - мониторинг ресурсов системы
AppCleaner - для удаления приложений
Caffeine - иногда полезная вещь, блокирует засыпание
VLC Video player - видео-плейер
MacPass - менеджер паролей (умеет читать базу от keepassx)
Обзор лучших файловых менеджеров для OS X

Разное

Включение выделения текста в окнах быстрого просмотра

defaults write com.apple.finder QLEnableTextSelection -bool TRUE;killall Finder

# для возврата к начальным установкам
defaults write com.apple.finder QLEnableTextSelection -bool FALSE;killall Finder

Отображение скрытых файлов в Finder

defaults write com.apple.finder AppleShowAllFiles -bool YES; killall Finder

# для возврата к начальным установкам
defaults write com.apple.finder AppleShowAllFiles -bool NO; killall Finder

Отключаем звук при старте системы

sudo nvram SystemAudioVolume=%80

Итог

03.01.2015 Каждый для себя сам решает стоит ли мигрировать под OsX или оставаться под Linux. Для пользователей Windows лучше выбрать Linux или OsX :). Все выше описанное личный опыт, на основе которо я принял решение - OsX не для меня. Основная причина: вроде как бы и есть нужный функционал, но он сделан как-то не по-людкси, а если хочешь что-то поменять - изволь ... 'мыши плакали, кололись... но продолжали есть кактус' это не про меня :).

Mac mini продан и я снова рад настроенному под меня Archlinux + XFCE - все минималистично, ничего лишнего и главное функционально!