f-f-ff-factory

gistfile1.js

//factory returns entire API response, controller is responsible for parsing the return value

.factory('CapitalData', function(API_AUTH, $http, $q, SEARCH_PATH){
  return function(countryId, capital){
    var defer = $q.defer();
    $http.get(SEARCH_PATH+'&name_equals='+capital+'&country='+countryId+API_AUTH)
    .success(function(data){
      defer.resolve(data);
    });
    return defer.promise;
  };
});

.controller('countryCtrl', function($scope, CapitalData){
  CapitalData(id, capital).then(function(data){
    $scope.capital = data.geonames[0]; //controller takes what it needs from the response
  });
});

//option 2:

//controller knows nothing about CountryData's return format
.factory('CapitalData', function(API_AUTH, $http, $q, SEARCH_PATH){
  return function(countryId, capital){
    var defer = $q.defer();
    $http.get(SEARCH_PATH+'&name_equals='+capital+'&country='+countryId+API_AUTH)
    .success(function(data){
      defer.resolve(data.geonames[0]);  //factory is responsible for passing correct data
    });
    return defer.promise;
  };
});

.controller('countryCtrl', function($scope, CapitalData){
  CapitalData(id, capital).then(function(data){
    $scope.capital = data; //controller is spoonfed data from service
  });
});