EVOLUTION-MANAGER

Edit File: $provide.html

<a href='https://github.com/angular/angular.js/edit/v1.3.x/src/auto/injector.js?message=docs($provide)%3A%20describe%20your%20change...#L313' class='improve-docs btn btn-primary'><i class="glyphicon glyphicon-edit">&nbsp;</i>Improve this Doc</a>

<a href='https://github.com/angular/angular.js/tree/v1.3.9/src/auto/injector.js#L313' class='view-source pull-right btn btn-primary'>
  <i class="glyphicon glyphicon-zoom-in">&nbsp;</i>View Source
</a>

<header class="api-profile-header">
  <h1 class="api-profile-header-heading">$provide</h1>
  <ol class="api-profile-header-structure naked-list step-list">

<li>
      - service in module <a href="api/auto">auto</a>
    </li>
  </ol>
</header>

<div class="api-profile-description">
  <p>The <a href="api/auto/service/$provide">$provide</a> service has a number of methods for registering components
with the <a href="api/auto/service/$injector">$injector</a>. Many of these functions are also exposed on
<a href="api/ng/type/angular.Module"><code>angular.Module</code></a>.</p>
<p>An Angular <strong>service</strong> is a singleton object created by a <strong>service factory</strong>.  These <strong>service
factories</strong> are functions which, in turn, are created by a <strong>service provider</strong>.
The <strong>service providers</strong> are constructor functions. When instantiated they must contain a
property called <code>$get</code>, which holds the <strong>service factory</strong> function.</p>
<p>When you request a service, the <a href="api/auto/service/$injector">$injector</a> is responsible for finding the
correct <strong>service provider</strong>, instantiating it and then calling its <code>$get</code> <strong>service factory</strong>
function to get the instance of the <strong>service</strong>.</p>
<p>Often services have no configuration options and there is no need to add methods to the service
provider.  The provider will be no more than a constructor function with a <code>$get</code> property. For
these cases the <a href="api/auto/service/$provide">$provide</a> service has additional helper methods to register
services without specifying a provider.</p>
<ul>
<li><a href="api/auto/service/$provide#provider">provider(provider)</a> - registers a <strong>service provider</strong> with the
  <a href="api/auto/service/$injector">$injector</a></li>
<li><a href="api/auto/service/$provide#constant">constant(obj)</a> - registers a value/object that can be accessed by
  providers and services.</li>
<li><a href="api/auto/service/$provide#value">value(obj)</a> - registers a value/object that can only be accessed by
  services, not providers.</li>
<li><a href="api/auto/service/$provide#factory">factory(fn)</a> - registers a service <strong>factory function</strong>, <code>fn</code>,
  that will be wrapped in a <strong>service provider</strong> object, whose <code>$get</code> property will contain the
  given factory function.</li>
<li><a href="api/auto/service/$provide#service">service(class)</a> - registers a <strong>constructor function</strong>, <code>class</code>
  that will be wrapped in a <strong>service provider</strong> object, whose <code>$get</code> property will instantiate
   a new object using the given constructor function.</li>
</ul>
<p>See the individual methods for more information and examples.</p>

</div>

<div>

<h2>Methods</h2>
<ul class="methods">
  <li id="provider">
    <h3><p><code>provider(name, provider);</code></p>

</h3>
    <div><p>Register a <strong>provider function</strong> with the <a href="api/auto/service/$injector">$injector</a>. Provider functions
are constructor functions, whose instances are responsible for &quot;providing&quot; a factory for a
service.</p>
<p>Service provider names start with the name of the service they provide followed by <code>Provider</code>.
For example, the <a href="api/ng/service/$log">$log</a> service has a provider called
<a href="api/ng/provider/$logProvider">$logProvider</a>.</p>
<p>Service provider objects can have additional methods which allow configuration of the provider
and its service. Importantly, you can configure what kind of service is created by the <code>$get</code>
method, or how that service will act. For example, the <a href="api/ng/provider/$logProvider">$logProvider</a> has a
method <a href="api/ng/provider/$logProvider#debugEnabled">debugEnabled</a>
which lets you specify whether the <a href="api/ng/service/$log">$log</a> service will log debug messages to the
console or not.</p>
</div>

<h4>Parameters</h4>
    
<table class="variables-matrix input-arguments">
  <thead>
    <tr>
      <th>Param</th>
      <th>Type</th>
      <th>Details</th>
    </tr>
  </thead>
  <tbody>
    
    <tr>
      <td>
        name
        
        
      </td>
      <td>
        <a href="" class="label type-hint type-hint-string">string</a>
      </td>
      <td>
        <p>The name of the instance. NOTE: the provider will be available under <code>name +
                        &#39;Provider&#39;</code> key.</p>

</td>
    </tr>
    
    <tr>
      <td>
        provider
        
        
      </td>
      <td>
        <a href="" class="label type-hint type-hint-object">Object</a><a href="" class="label type-hint type-hint-function">function()</a>
      </td>
      <td>
        <p>If the provider is:</p>
<ul>
<li><code>Object</code>: then it should have a <code>$get</code> method. The <code>$get</code> method will be invoked using
<a href="api/auto/service/$injector#invoke">$injector.invoke()</a> when an instance needs to be created.</li>
<li><code>Constructor</code>: a new instance of the provider will be created using
<a href="api/auto/service/$injector#instantiate">$injector.instantiate()</a>, then treated as <code>object</code>.</li>
</ul>